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

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

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

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

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

Тарифы и подписки

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

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

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

OpenAI

Anthropic

Google AI

DeepSeek

Zhipu AI

Moonshot AI

Tencent

Meta

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