سازگار با OpenAI

API سازگار با OpenAI؛ فقط Base URL را عوض کنید

اگر برنامه‌تان با OpenAI SDK یا هر کلاینت سازگار با OpenAI کار می‌کند، برای اتصال به GPT، Claude، Gemini و مدل‌های دیگر فقط سه مقدار را عوض کنید: Base URL، کلید API و نام مدل.

  • 0مدل فعال
  • 0ارائه‌دهندهٔ مدل
  • 0مدل رایگان

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

نمونه‌ها با آدرس واقعی API همین سایت ساخته شده‌اند. YOUR_API_KEY را با کلیدی که از پنل می‌سازید جایگزین کنید.

Base URL https://apiex.cloud/api/v1/
curl https://apiex.cloud/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-terra-pro",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://apiex.cloud/api/v1/",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="openai/gpt-5.6-terra-pro",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://apiex.cloud/api/v1/",
  apiKey: "YOUR_API_KEY",
});

const response = await client.chat.completions.create({
  model: "openai/gpt-5.6-terra-pro",
  messages: [{ role: "user", content: "Hello!" }],
});

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

چه قابلیت‌هایی پشتیبانی می‌شود؟

اندپوینت‌های اصلی با ساختار درخواست و پاسخ OpenAI کار می‌کنند. فهرست کامل اندپوینت‌ها و پارامترها در مستندات آمده است.

Chat Completions

ساخت پاسخ چت با پشتیبانی از استریم، ابزارها (tools) و ورودی تصویر.

Embeddings

ساخت بردار متن برای جست‌وجوی معنایی و سیستم‌های RAG.

فهرست مدل‌ها

GET /models بدون نیاز به کلید، کاتالوگ عمومی را برمی‌گرداند و با کلید، فقط مدل‌های مجاز همان کلید را.

برآورد هزینه

POST /cost/estimate بیشینهٔ هزینهٔ یک درخواست را بدون ارسال به مدل و بدون کسر از کیف پول برمی‌گرداند.

صدا و ویدئو

تبدیل متن به گفتار، تبدیل گفتار به متن و تولید ویدئو با اندپوینت‌های جداگانه.

خطاهای استاندارد

خطاها با ساختار error شامل message، type و code برمی‌گردند تا مدیریتشان در کلاینت ساده باشد.

اتصال ابزارها و کتابخانه‌ها

هر ابزاری که تنظیم Base URL و کلید API سفارشی داشته باشد با همین سه مقدار وصل می‌شود. برای نمونه OpenAI SDK پایتون و Node.js، LangChain، LlamaIndex، n8n، Open WebUI و Continue چنین تنظیمی دارند؛ نام فیلدها در هر ابزار کمی متفاوت است.

Base URL https://apiex.cloud/api/v1/
API Key کلیدی که با پیشوند apx- از پنل کاربری می‌سازید
Model شناسهٔ عمومی مدل از صفحهٔ مدل‌ها، مثلاً openai/gpt-5.6-terra-pro

مهاجرت در سه قدم

  1. 1

    Base URL را عوض کنید

    آدرس پایهٔ کلاینت را روی آدرس API همین سایت بگذارید.

  2. 2

    کلید API بسازید

    در پنل کاربری، بخش کلیدها، کلید جدید بسازید. برای هر کلید می‌توانید سقف هزینه، انقضا، IP مجاز، مدل‌های مجاز و محدودیت نرخ تعیین کنید.

  3. 3

    نام مدل را انتخاب کنید

    شناسهٔ مدل مورد نظر را از صفحهٔ مدل‌ها بردارید و در پارامتر model بگذارید.

چرا از یک درگاه واحد استفاده کنیم؟

یک کلید، چند مدل

به‌جای مدیریت کلید و حساب جدا برای هر ارائه‌دهنده، با یک Base URL و یک کیف پول کار می‌کنید.

جایگزینی خودکار هنگام خطا

چند سرویس می‌توانند پشتیبان یک مدل باشند. اگر درخواستی شکست بخورد به سرویس بعدی می‌رود و سرویس‌هایی که مدام خطا می‌دهند موقتاً کنار گذاشته می‌شوند.

کنترل هزینه و دسترسی

سقف هزینه، انقضا، IP مجاز، مدل‌های مجاز و محدودیت نرخ را برای هر کلید جداگانه تعیین کنید.

گزارش هر درخواست

توکن، هزینه، زمان پاسخ و وضعیت هر درخواست ثبت می‌شود تا بدانید هزینه کجا رفته است.

پرسش‌های متداول

آیا این API دقیقاً مثل OpenAI است؟

اندپوینت‌های اصلی (چت، امبدینگ، صدا و ویدئو) از ساختار درخواست و پاسخ OpenAI پیروی می‌کنند، اما همهٔ اندپوینت‌ها و پارامترهای OpenAI پشتیبانی نمی‌شوند. فهرست دقیق در مستندات است.

استریم و Function Calling پشتیبانی می‌شود؟

بله، اندپوینت چت از استریم، ابزارها (tools) و ورودی تصویر پشتیبانی می‌کند. در دسترس بودن هر قابلیت به خود مدل هم بستگی دارد.

نام مدل‌ها را از کجا بیاورم؟

از صفحهٔ مدل‌ها یا با GET /models. شناسهٔ عمومی هر مدل کنار نام آن نوشته شده و با یک کلیک کپی می‌شود.

اگر یک سرویس خطا بدهد چه می‌شود؟

اگر برای آن مدل چند سرویس تعریف شده باشد، درخواست ناموفق خودکار به سرویس بعدی می‌رود. خطاها هم با ساختار استاندارد برمی‌گردند تا کلاینت بتواند آن‌ها را مدیریت کند.

آیا می‌توانم برای هر پروژه کلید جدا و محدود بسازم؟

بله. هر کلید سقف هزینه، تاریخ انقضا، IP مجاز، مدل‌های مجاز و محدودیت نرخ جداگانه دارد.

مصرف و هزینه را کجا ببینم؟

در پنل کاربری برای هر درخواست مدل، توکن، هزینه، مدت‌زمان و وضعیت ثبت می‌شود و گزارش‌ها با نمودار و فیلتر در دسترس‌اند.

ادامهٔ مسیر

امروز به GPT، Claude و Gemini وصل شوید

کلید بسازید، Base URL را عوض کنید و اولین درخواست را بفرستید.