مستندات

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

احراز هویت

هر درخواست باید کلید API شما را در هدر Authorization با استفاده از طرح Bearer شامل شود.

Authorization: Bearer YOUR_API_KEY

کلیدها را از پنل خود ایجاد و مدیریت کنید: بخش کلیدهای API

شروع سریع

اولین درخواست خود را با زبان انتخابی ارسال کنید. عبارت YOUR_API_KEY را با کلیدی از پنل خود جایگزین کنید.

curl https://apiex.cloud/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "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="gpt-4o-mini",
    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: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello!" }],
});

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

$ch = curl_init( "https://apiex.cloud/api/v1/chat/completions" );

curl_setopt_array( $ch, array(
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => array(
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ),
    CURLOPT_POSTFIELDS => json_encode( array(
        'model'    => 'gpt-4o-mini',
        'messages' => array(
            array( 'role' => 'user', 'content' => 'Hello!' ),
        ),
    ) ),
) );

$response = json_decode( curl_exec( $ch ), true );
echo $response['choices'][0]['message']['content'];

خطاها

این API از کدهای وضعیت استاندارد HTTP استفاده می‌کند. کدهای محدوده 2xx نشان‌دهنده موفقیت؛ 4xx نشان‌دهنده مشکل در درخواست؛ و 5xx نشان‌دهنده مشکل از سمت ما هستند.

پاسخ‌های خطا دارای ساختار JSON ثابتی هستند:

{
  "error": {
    "type": "insufficient_balance",
    "message": "Wallet balance is too low to complete this request.",
    "code": 402
  }
}

آدرس پایه و اندپوینت‌ها

همه درخواست‌ها به این آدرس پایه ارسال می‌شوند:

https://apiex.cloud/api/v1/

تکمیل‌های چت

یک پاسخ مدل برای یک مکالمه مشخص ایجاد می‌کند. ساختار درخواست و پاسخ با API تکمیل چت OpenAI مطابقت دارد.

پارامترهای درخواست

نمونه پاسخ

{
  "id": "chatcmpl_8k2f...",
  "object": "chat.completion",
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 10,
    "total_tokens": 19
  }
}

پاسخ‌های استریم

برای دریافت پاسخ به صورت افزایشی به عنوان رویدادهای ارسالی از سرور، "stream": true را تنظیم کنید که برای رابط‌های چت ایده‌آل است.

data: {"choices":[{"delta":{"content":"Hello"}}]}

data: {"choices":[{"delta":{"content":"!"}}]}

data: [DONE]

محدودیت‌های نرخ

محدودیت‌های نرخ از پایداری درگاه برای همه محافظت می‌کنند. محدودیت‌ها به طرح فعال شما بستگی دارند و برای هر کلید API اعمال می‌شوند.

هر پاسخ شامل هدرهایی است که وضعیت محدودیت فعلی شما را توصیف می‌کند:

کیف پول و صورت‌حساب

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

کلیدهای API

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

بهترین روش‌ها

• برای هر برنامه یا محیط (تولید، استیجینگ، محلی) یک کلید جداگانه ایجاد کنید.
• کلیدها را در متغیرهای محیطی ذخیره کنید، هرگز در کنترل منبع قرار ندهید.
• از گروه‌های کلید برای محدود کردن مخارج یا محدود کردن یک کلید به مدل‌های خاص استفاده کنید.
• اگر مشکوک هستید که کلید لو رفته است، فوراً آن را لغو کنید.

ایجاد یک کلید API

طرح‌ها و اشتراک‌ها

یک طرح برای اعتبار ماهانه قابل پیش‌بینی انتخاب کنید، یا از حالت پرداخت به میزان مصرف استفاده کرده و کیف پول خود را شارژ نگه دارید.

مدل‌ها و ارائه‌دهندگان

درگاه در حال حاضر به ارائه‌دهندگان زیر متصل است. برای دریافت لیست دقیق و زنده مدل‌ها، با کلید API خود متد GET /models را فراخوانی کنید.

OpenAI

Anthropic

Google AI

DeepSeek

Zhipu AI

Moonshot AI

Tencent

Meta

Agnes

Nvidia

سوالات متداول