مستندات

1. با شماره موبایل وارد شوید.
2. از صفحه‌ی خرید اعتبار یک بسته بخرید.
3. در داشبورد یک کلید API بسازید (کلید فقط یک بار نمایش داده می‌شود).
4. در برنامه‌ی خود base_url را عوض کنید، کلید را وارد کنید و نام مدل را بنویسید.

آدرس‌ها و احراز هویت

کلید را در هدر Authorization: Bearer sk-... بفرستید. در فرمت Anthropic هدر x-api-key هم پذیرفته می‌شود. هر دو فرمت با همه‌ی مدل‌ها کار می‌کنند؛ یعنی می‌توانید GPT را با فرمت Anthropic یا Claude را با فرمت OpenAI صدا بزنید.

اتصال ابزارها

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://api.2928.ir/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "سلام!"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-...",
  baseURL: "https://api.2928.ir/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "سلام!" }],
});
console.log(response.choices[0].message.content);

curl https://api.2928.ir/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "سلام!"}],
    "stream": true
  }'

import anthropic

client = anthropic.Anthropic(
    api_key="sk-...",
    base_url="https://api.2928.ir",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "سلام!"}],
)
print(message.content[0].text)

# macOS / Linux — در ترمینال، قبل از اجرای claude:
export ANTHROPIC_BASE_URL="https://api.2928.ir"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
claude

# Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://api.2928.ir"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."
$env:ANTHROPIC_MODEL="claude-sonnet-5"
claude

1. Cursor → Settings → Models
2. بخش «OpenAI API Key» را باز کنید و کلید را وارد کنید:
   sk-...
3. گزینه‌ی «Override OpenAI Base URL» را روشن کنید و بنویسید:
   https://api.2928.ir/v1
4. با «Add model» نام مدل را اضافه کنید، مثلاً:
   claude-sonnet-5
5. Verify را بزنید و همان مدل را در چت انتخاب کنید.

ابزارهای دیگر (Cline، Continue، Roo Code، LangChain، n8n، LobeChat و...) معمولاً گزینه‌ی «OpenAI Compatible» دارند: Base URL را https://api.2928.ir/v1 بگذارید، کلید را وارد کنید و نام مدل را بنویسید.

استریم

با stream: true پاسخ به‌صورت Server-Sent Events ارسال می‌شود.

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "یک شعر کوتاه بنویس"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Function Calling

پارامتر tools مثل API رسمی OpenAI کار می‌کند؛ برای GPT و Claude.

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "هوای تهران چطور است؟"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get the current weather for a city",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"],
            },
        },
    }],
)
print(response.choices[0].message.tool_calls)

تصویر

تصویر را به‌صورت base64 بفرستید. لینک مستقیم هم پشتیبانی می‌شود، ولی بعضی سایت‌ها دانلود خودکار را مسدود می‌کنند؛ base64 همیشه کار می‌کند.

import base64

image = base64.b64encode(open("photo.jpg", "rb").read()).decode()
response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "در این تصویر چه می‌بینی؟"},
        {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{image}"}},
    ]}],
)

خطاها

نام مدل‌ها