Документация

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
  }
}

Базовый URL и конечные точки

Все запросы выполняются по этому базовому URL:

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

Завершения чата

Создает ответ модели для заданного диалога. Форматы запроса и ответа соответствуют API OpenAI Chat Completions.

Параметры запроса

Пример ответа

{
  "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-ключи аутентифицируют ваши запросы и могут быть ограничены определенными моделями или лимитами использования через группы ключей.

Лучшие практики

• Создавайте отдельный ключ для каждого приложения или среды (production, staging, local).
• Храните ключи в переменных окружения, никогда не добавляйте их в систему контроля версий.
• Используйте группы ключей, чтобы ограничить расходы или доступ к определенным моделям.
• Немедленно отзовите ключ, если подозреваете, что он был скомпрометирован.

Создать API-ключ

Тарифные планы и подписки

Выберите план для предсказуемых ежемесячных кредитов или оставайтесь на оплате по факту использования, просто пополняя свой кошелек.

Модели и провайдеры

Шлюз в настоящее время направляет запросы к следующим провайдерам. Вызовите GET /models с вашим API-ключом для получения точного списка моделей в реальном времени.

OpenAI

Anthropic

Google AI

DeepSeek

Zhipu AI

Moonshot AI

Tencent

Meta

Agnes

Nvidia

Часто задаваемые вопросы