سایت در حال توسعه است — برخی قابلیت‌ها ممکن است موقتی یا آزمایشی باشند.
IranBrain IranBrain
ورود شروع رایگان
مدل‌ها گالری تعرفه‌ها API مجله
MUAPI & GATEWAY COMPATIBLE • DEVELOPER DOCS

API یکپارچه هوش مصنوعی؛ چند مدل با یک اتصال

راهنمای API برای اتصال به چت، تصویر، ویدیو و صدا

سیستم API IranBrain یک درگاه امن، پرسرعت و سازگار با OpenAI و Anthropic است. با کلید اختصاصی با پیشوند sk-ib- می‌توانید به مدل‌های چت فعال از طریق /v1/chat/completions و /v1/messages متصل شوید. تولید تصویر، ویدیو، صدا و ۳بعدی از طریق داشبورد کاربری در دسترس است.

دسترسی عمومی API فعلاً توسط مدیریت غیرفعال است. پس از فعال‌سازی می‌توانید درخواست‌های خود را ارسال کنید.

معرفی و نحوه عملکرد

در IranBrain، نیازی به ساخت حساب‌های متفرق در سرویس‌های خارجی مختلف یا مدیریت کلیدهای متعدد ندارید. درگاه API ما تمام درخواست‌های شما را از طریق سرویس قدرتمند MuAPI و سایر ارائه‌دهندگان معتبر پردازش می‌کند.

سازگاری کامل استاندارد

کاملاً منطبق با ساختار استاندارد OpenAI (مثل /v1/chat/completions) و Anthropic (مثل /v1/messages).

پردازش استریم واقعی (Streaming)

پشتیبانی کامل از Server-Sent Events (SSE) برای دریافت پاسخ تکه‌تکه در برنامه‌ها، چت‌بات‌ها و ابزارهای دستیار.

کسر اعتبار هوشمند و شفاف

هزینه هر فراخوانی مستقیماً بر اساس میزان credit_cost همان مدل از کیف‌پول شما کسر می‌شود.

امنیت بالا

کلید اصلی سرویس‌دهنده‌ها محفوظ بوده و کاربران فقط از توکن شخصی خود در IranBrain استفاده می‌کنند.

دریافت و مدیریت کلید API

  1. وارد حساب کاربری خود شوید و به صفحه تنظیمات پروفایل بروید.
  2. در کارت «کلیدهای API»، یک عنوان برای کلید خود (مثلاً My App یا OpenClaw Key) وارد کنید.
  3. بر روی دکمه «ساخت کلید» کلیک کنید.
  4. کلید کامل ساخته‌شده با پیشوند sk-ib-... فقط یک‌بار نشان داده می‌شود؛ آن را کپی کرده و در فایل .env پروژه‌تان ذخیره کنید.
نکته امنیتی: هرگز کلید API خود را در کدهای سمت کلاینت (Front-end JS) قرار ندهید یا در گیت‌هاب عمومی Commit نکنید. در صورت لو رفتن کلید، بلافاصله آن را از همان بخش باطل (Revoke) کنید.

آدرس‌های پایه‌ای (Base URL)

بر اساس پروتکل و ابزاری که استفاده می‌کنید، Base URL مناسب را تنظیم کنید:

سازگار با OpenAI / Gemini / Python SDK / cURL Standard API v1
https://iran-brain.com/api/v1
سازگار با Anthropic Claude / OpenClaw / Claude SDK Anthropic API
https://iran-brain.com/api

کلاینت‌های Anthropic به‌طور خودکار مسیر /v1/messages را به انتهای این آدرس اضافه می‌کنند.

مسیرها (Endpoints)

متد مسیر Endpoint توضیحات و عملکرد
GET /v1/models دریافت فهرست تمام مدل‌های چت فعال به فرمت کاتالوگ OpenAI
POST /v1/chat/completions ارسال درخواست چت تک‌مرحله‌ای یا استریم (OpenAI Format)
POST /v1/messages ارسال درخواست پیام تک‌مرحله‌ای یا استریم (Anthropic Format)
هدر احراز هویت: Authorization: Bearer sk-ib-... یا x-api-key: sk-ib-...

نمونه کدهای اتصال (Code Examples)

نمونه کد اتصال با کتابخانه‌های محبوب برنامه‌نویسی:

cURL (درخواست مستقیم)

curl https://iran-brain.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-ib-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "سلام، راهنمای استفاده از API را خلاصه بگو."}
    ],
    "stream": false
  }'

Python (با پکیج رسمی openai)

from openai import OpenAI

client = OpenAI(
    api_key="sk-ib-YOUR_API_KEY",
    base_url="https://iran-brain.com/api/v1"
)

# پاسخ معمولی
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "پایتون چیست؟"}]
)
print(response.choices[0].message.content)

# پاسخ به‌صورت استریم (Stream)
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "یک شعر کوتاه بگو."}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

JavaScript / Node.js (OpenAI SDK)

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'sk-ib-YOUR_API_KEY',
  baseURL: 'https://iran-brain.com/api/v1',
});

async function run() {
  const completion = await openai.chat.completions.create({
    model: 'gpt-4o-mini',
    messages: [{ role: 'user', content: 'سلام' }],
  });

  console.log(completion.choices[0].message.content);
}

run();

PHP (cURL)

<?php

$ch = curl_init('https://iran-brain.com/api/v1/chat/completions');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-ib-YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model' => 'gpt-4o-mini',
        'messages' => [
            ['role' => 'user', 'content' => 'سلام']
        ]
    ]),
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $response['choices'][0]['message']['content'];

پیکربندی ابزارهای خارجی (OpenClaw, Cursor, Chatbox...)

می‌توانید کلید API ایران‌برین را به سادگی در ابزارها و کلاینت‌های محبوب تنظیم کنید:

۱. اتصال به OpenClaw

  1. دستور openclaw configure --section models را در ترمینال اجرا کنید.
  2. گزینه Custom Provider را انتخاب کنید.
  3. آدرس پایه‌ای (Base URL) را وارد کنید:
    • پروتکل OpenAI: https://iran-brain.com/api/v1
    • پروتکل Claude: https://iran-brain.com/api
  4. کلید API ساخته‌شده با پیشوند sk-ib-... را وارد کنید.
  5. شناسه مدل دلخواه را از جدول مدل‌های فعال انتخاب کرده و ثبت کنید.

۲. استفاده در Cursor / VSCode Extensions

در تنظیمات افزونه‌های چت یا افزونه‌های AI، بخش OpenAI Base URL را برابر https://iran-brain.com/api/v1 و API Key را برابر کلید sk-ib-... خود قرار دهید.

۳. کلاینت‌های وب و دسکتاپ (NextChat, Cherry Studio, Chatbox)

در بخش تنظیمات ارائه دهنده (Provider Settings)، گزینه Custom OpenAI یا OpenAI Proxy را انتخاب نمایید. فیلد Endpoint را روی https://iran-brain.com/api/v1 و API Key را روی کلید خود بگذارید.

فهرست مدل‌های قابل‌استفاده در API

این فهرست دقیقاً همان خروجی GET /v1/models است و فقط مدل‌های چت فعال را شامل می‌شود. شناسهٔ ستون «شناسه مدل» را در فیلد model قرار دهید. مدل‌های تصویر، ویدیو، صدا و سایر انواع از طریق داشبورد در دسترسند و در این API پشتیبانی نمی‌شوند.

مدل‌های چت و پردازش متن

(47 مدل)
شناسه مدل (Model ID) نام مدل ارائه‌دهنده هزینه (اعتبار)
anthropic/claude-3.5-haiku anthropic: Claude 3.5 Haiku claude 175 اعتبار
anthropic/claude-3.7-sonnet anthropic: Claude 3.7 Sonnet claude 525 اعتبار
anthropic/claude-4-sonnet anthropic: Claude 4 Sonnet claude 525 اعتبار
anthropic/claude-4.5-haiku anthropic: Claude 4.5 Haiku claude 175 اعتبار
anthropic/claude-4.5-sonnet anthropic: Claude 4.5 Sonnet claude 525 اعتبار
anthropic/claude-fable-5 anthropic: Claude Fable 5 claude 1,750 اعتبار
anthropic/claude-opus-4.6 anthropic: Claude Opus 4.6 claude 875 اعتبار
anthropic/claude-opus-4.7 anthropic: Claude Opus 4.7 claude 875 اعتبار
anthropic/claude-sonnet-4.6 anthropic: Claude Sonnet 4.6 claude 525 اعتبار
anthropic/claude-sonnet-5 anthropic: Claude Sonnet 5 claude 350 اعتبار
deepseek-ai/deepseek-r1 deepseek-ai: Deepseek R1 deepseek 438 اعتبار
deepseek-ai/deepseek-v3 deepseek-ai: Deepseek V3 deepseek 109 اعتبار
deepseek-ai/deepseek-v3.1 deepseek-ai: Deepseek V3.1 deepseek 84 اعتبار
google/gemini-2.5-flash google: Gemini 2.5 Flash gemini 78 اعتبار
google/gemini-3-flash google: Gemini 3 Flash gemini 100 اعتبار
google/gemini-3.1-pro google: Gemini 3.1 Pro gemini 400 اعتبار
google/gemini-3.5-flash google: Gemini 3.5 Flash gemini 300 اعتبار
ibm-granite/granite-3.2-8b-instruct ibm-granite: Granite 3.2 8B Instruct custom 8 اعتبار
ibm-granite/granite-3.3-8b-instruct ibm-granite: Granite 3.3 8B Instruct custom 8 اعتبار
ibm-granite/granite-4.0-h-small ibm-granite: Granite 4.0 H Small custom 9 اعتبار
ibm-granite/granite-4.1-8b ibm-granite: Granite 4.1 8B custom 9 اعتبار
ibm-granite/granite-vision-3.3-2b ibm-granite: Granite Vision 3.3 2B custom 6 اعتبار
ibm-granite/granite-vision-4.1-4b ibm-granite: Granite Vision 4.1 4B custom 9 اعتبار
meta/llama-4-maverick-instruct meta: Llama 4 Maverick Instruct custom 36 اعتبار
meta/llama-4-scout-instruct meta: Llama 4 Scout Instruct custom 25 اعتبار
meta/llama-guard-4-12b meta: Llama Guard 4 12B custom 15 اعتبار
openai/gpt-4.1 openai: Gpt 4.1 openai 300 اعتبار
openai/gpt-4.1-mini openai: Gpt 4.1 Mini openai 60 اعتبار
openai/gpt-4.1-nano openai: Gpt 4.1 Nano openai 15 اعتبار
openai/gpt-4o openai: Gpt 4O openai 375 اعتبار
openai/gpt-4o-mini openai: Gpt 4O Mini openai 23 اعتبار
openai/gpt-5 openai: Gpt 5 openai 313 اعتبار
openai/gpt-5-mini openai: Gpt 5 Mini openai 63 اعتبار
openai/gpt-5-nano openai: Gpt 5 Nano openai 13 اعتبار
openai/gpt-5-pro openai: Gpt 5 Pro openai 3,750 اعتبار
openai/gpt-5-structured openai: Gpt 5 Structured openai 313 اعتبار
openai/gpt-5.1 openai: Gpt 5.1 openai 313 اعتبار
openai/gpt-5.2 openai: Gpt 5.2 openai 438 اعتبار
openai/gpt-5.4 openai: Gpt 5.4 openai 500 اعتبار
openai/gpt-5.6-luna openai: Gpt 5.6 Luna openai 200 اعتبار
openai/gpt-5.6-sol openai: Gpt 5.6 Sol openai 500 اعتبار
openai/gpt-5.6-terra openai: Gpt 5.6 Terra openai 500 اعتبار
openai/gpt-oss-120b openai: Gpt Oss 120B openai 27 اعتبار
openai/gpt-oss-20b openai: Gpt Oss 20B openai 14 اعتبار
qwen/qwen3-235b-a22b-instruct-2507 qwen: Qwen3 235B A22B Instruct 2507 custom 40 اعتبار
qwen/qwen3-7-plus qwen: Qwen3 7 Plus custom 41 اعتبار
twangodev/qwenasr twangodev: Qwenasr wan 80 اعتبار

هزینه و کسر اعتبار (Billing & Credits)

نحوه کسر اعتبار در بخش API دقیقاً همانند کسر اعتبار در داشبورد کاربری است. هر درخواست موفق به میزان تعیین‌شده در فیلد credit_cost همان مدل از کیف‌پول شما کسر خواهد شد.

  • اگر اعتبار حساب شما کمتر از هزینه مدل درخواستی باشد، پاسخ با کد 402 (insufficient_credits) برگشت داده می‌شود.
  • اگر به دلیل خطای شبکه یا سرویس‌دهنده، درخواست قبل از اتمام با خطا مواجه شود، هیچ اعتباری کسر نمی‌گردد.
  • در درخواست‌های استریم (Streaming)، کسر اعتبار در ابتدای برقراری ارتباط موثر انجام می‌پذیرد.

می‌توانید برای شارژ حساب خود به بخش کیف پول کاربری مراجعه فرمایید.

کدهای خطا و فرمت پاسخ (Error Handling)

کد HTTP کد خطا (error.code) علت و توضیحات
401 invalid_api_key کلید API همراه درخواست نادرس است، وجود ندارد یا باطل شده است.
402 insufficient_credits موجودی کیف‌پول شما برای فراخوانی این مدل کافی نیست.
404 model_not_found شناسه مدل (model) ارسال‌شده وجود ندارد یا غیرفعال است.
502 upstream_error سرویس‌دهنده اصلی (MuAPI یا ارائه‌دهنده مدل) دچار خطا شده است.
503 api_disabled سرویس API عمومی توسط مدیریت غیرفعال شده است.

فرمت ساختار پاسخ خطا:

{
  "error": {
    "message": "موجودی اعتبار شما کافی نیست.",
    "type": "insufficient_quota",
    "code": "insufficient_credits"
  }
}
سوالی دارید یا به راهنمایی بیشتری نیاز دارید؟ ارسال تیکت پشتیبانی یا مراجعه به مدیریت کلیدها در پروفایل.