معمولی

وصل کردن هر SDK یا کتابخونه‌ی سازگار با OpenAI

الگوی کلی برای وصل‌کردن هر SDK یا کتابخونه‌ای که فرمت OpenAI رو می‌فهمه — پایتون، Node، یا هر زبون دیگه‌ای.

اگه api-quickstart رو با curl امتحان کردی و حالا می‌خوای همون کار رو از داخل کد پایتون، Node، یا هر SDK دیگه‌ای که با فرمت OpenAI کار می‌کنه انجام بدی — این مقاله برای توئه. تا آخرش، یه SDK رسمی سازگار با OpenAI رو مستقیم به بنفش وصل می‌کنی، بدون این‌که چیزی از خود SDK رو دستکاری کنی.

قاعده‌ی کلی

هر SDK که رسماً از OpenAI پشتیبانی می‌کنه، یه راه برای override کردن base_url (یا اسم مشابهش) داره. همون‌جا آدرس سرویس بنفش رو بذار، api_key رو هم کلید خودت بذار — همین. بقیه‌ی SDK دقیقاً همون‌طوری کار می‌کنه که با OpenAI کار می‌کرد.

هم آدرس و هم کلید رو از صفحه‌ی «کلیدهای API» بگیر — آدرس رو از ردیف «ابزارهای سازگار با OpenAI — با /v1» تو کارت «آدرس سرویس»؛ SDKهای OpenAI خودشون فقط /chat/completions رو اضافه می‌کنن، پس /v1 باید تو خود آدرس باشه. همیشه از همون‌جا بگیر، هیچ‌وقت یه آدرس رو جایی هاردکد نکن؛ این آدرس بین محیط‌های مختلف فرق می‌کنه.

پایتون (SDK رسمی openai)

python
from openai import OpenAI

client = OpenAI(
    base_url="YOUR_SERVICE_URL",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "سلام، خودت رو معرفی کن"}],
)
print(response.choices[0].message.content)

Node / TypeScript (SDK رسمی openai)

ts
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "YOUR_SERVICE_URL",
  apiKey: "YOUR_API_KEY",
});

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [{ role: "user", content: "سلام، خودت رو معرفی کن" }],
});
console.log(response.choices[0].message.content);

YOUR_MODEL_ID رو با شناسه‌ی یکی از مدل‌های فعال عوض کن — «auto» که تو داکیومنت خودِ OpenAI دیده باشی، مخصوص چت خودِ بنفش تو مرورگره و اینجا کار نمی‌کنه. لیست زنده‌ی مدل‌های فعال:

  • BGE-M3
  • Claude Haiku 4.5 — حدود ۱٬۲۴۹ تومان برای هر پیام معمولی
  • Claude Opus 5 — حدود ۶٬۲۴۵ تومان برای هر پیام معمولی
  • Claude Opus 5.5 — حدود ۴٬۹۹۶ تومان برای هر پیام معمولی
  • Claude Sonnet 4.6 — حدود ۳٬۷۴۷ تومان برای هر پیام معمولی
  • Claude Sonnet 5 — حدود ۲٬۴۹۸ تومان برای هر پیام معمولی
  • Claude Sonnet 5.5 — حدود ۲٬۴۹۸ تومان برای هر پیام معمولی
  • DeepSeek V4 Flash — حدود ۷۱ تومان برای هر پیام معمولی
  • Embed Multilingual V3
  • Gemini 3.1 Flash Lite — حدود ۳۵۴ تومان برای هر پیام معمولی
  • Gemini 3.1 Pro — حدود ۲٬۸۱۰ تومان برای هر پیام معمولی
  • Gemini 3.5 Flash — حدود ۲٬۱۰۸ تومان برای هر پیام معمولی
  • Gemma 4 26B A4B — حدود ۸۷ تومان برای هر پیام معمولی
  • Gemma 4 31B — حدود ۱۵۶ تومان برای هر پیام معمولی
  • GLM-4.7 Flash — حدود ۱۱۴ تومان برای هر پیام معمولی
  • GLM-5 — حدود ۱٬۱۶۱ تومان برای هر پیام معمولی
  • GPT Oss 120B — حدود ۴۴ تومان برای هر پیام معمولی
  • GPT-6 Astra — حدود ۱۲٬۴۹۰ تومان برای هر پیام معمولی
  • GPT-6 Luna — حدود ۱۲۵ تومان برای هر پیام معمولی
  • GPT-6.1 Sol — حدود ۲٬۴۹۸ تومان برای هر پیام معمولی
  • Grok 4.7 — حدود ۱٬۸۷۴ تومان برای هر پیام معمولی
  • Kimi K2 Thinking — حدود ۷۹۱ تومان برای هر پیام معمولی
  • Kimi K2.6 — حدود ۹۰۰ تومان برای هر پیام معمولی
  • Llama 3.3 70B Turbo — حدود ۹۷ تومان برای هر پیام معمولی
  • Llama 4 Scout 17B 16E — حدود ۹۴ تومان برای هر پیام معمولی
  • Mistral Large 3 — حدود ۵۵۲ تومان برای هر پیام معمولی
  • Mistral Small 3.2 24B Instruct — حدود ۷۰ تومان برای هر پیام معمولی
  • Multilingual E5 Large
  • Qwen3 235B A22B Instruct — حدود ۱۲۹ تومان برای هر پیام معمولی
  • Qwen3 Coder 480B A35B Turbo — حدود ۲۹۷ تومان برای هر پیام معمولی
  • Qwen3 Embedding 8B
  • Qwen3 VL 30B A3B — حدود ۱۶۶ تومان برای هر پیام معمولی
  • Qwen3.5 397B A17B — حدود ۶۸۱ تومان برای هر پیام معمولی
  • Qwen3.6 35B A3B — حدود ۱۹۶ تومان برای هر پیام معمولی
  • Qwen3.8 Max — حدود ۱٬۵۵۰ تومان برای هر پیام معمولی
  • Titan Embed Text V2

⚠️ این دو نمونه هنوز مستقیم روی SDKهای واقعی اجرا و تست نشدن. ساختارشون دقیقاً همون override استانداردیه که این SDKها مستند کردن، ولی قبل از قراردادنشون تو کد production خودت، یه بار محلی امتحانشون کن. اگه جواب نگرفتی، «رفع اشکال اتصال» رو ببین.

نکته برای هر SDK دیگه

اگه از یه زبون یا کتابخونه‌ی دیگه استفاده می‌کنی که مستقیماً از OpenAI پشتیبانی نمی‌کنه ولی می‌گه «سازگار با OpenAI»، دنبال یکی از این دو الگو بگرد:

  • یه پارامتر صریح مثل base_url / baseURL / endpoint موقع ساختن کلاینت.
  • یه متغیر محیطی مثل OPENAI_BASE_URL که SDK خودش می‌خونه.

اگه هیچ‌کدوم رو نداره — یعنی آدرس OpenAI رو تو خودِ کتابخونه هاردکد کرده — نمی‌تونی وصلش کنی.

چی کار نمی‌کنه

  • Claude Code و SDK رسمی Anthropic با این الگو وصل نمی‌شن، چون فرمت درخواست/پاسخ خودشون رو دارن. بنفش اون فرمت رو هم جواب می‌ده، ولی با شکل دیگه‌ی آدرس: ردیف بدون /v1 رو از همون کارت «آدرس سرویس» بردار. قدم‌به‌قدمش تو نصب Claude Code هست.
  • این مسیر (SDK مستقیم به gateway) هم به کیف پولت گیت شده — با یه سقف روی gateway، نه چک لحظه‌ای مثل چت. جزئیاتش تو «کنترل مصرف و هزینه» هست.
  • می‌تونی برای این SDK/پروژه یه کلید جدا بسازی (تا ده‌تا کلید فعال، هر کدوم با اسم و سقف مصرف مخصوص خودش) — از «کلیدهای API».