Руководство по API

APIYI — это совместимый с OpenAI AI-шлюз: один стандартный интерфейс и один API Key позволяют вам вызывать более 400 основных больших моделей. Эта страница — навигационный центр: она помогает вам быстро найти какую модель использовать, проверить эндпоинты онлайн и узнать, как интегрировать.

Обзор платформы

Режим совместимости с OpenAI

APIYI использует формат, совместимый с OpenAI. Когда всё заработает, при смене моделей нужно лишь изменить поле model — всё остальное остаётся тем же:

from openai import OpenAI

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

# Switching models = change only the `model` field, nothing else
response = client.chat.completions.create(
    model="gpt-5-chat-latest",   # swap in any supported model name
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

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

Поддерживаемые возможности

Поддерживается

Chat Completions
Генерация изображений / видео
Транскрибация речи (Whisper)
Embeddings
Function Calling
Потоковая передача вывода (SSE)
Стандартные параметры OpenAI: temperature, top_p, max_tokens, и т. д.
эндпоинт Responses

Не поддерживается

Fine-tuning
Управление файлами
Управление организацией
Управление тарификацией

Выберите модель

Не уверены, какую модель использовать? Эти две страницы регулярно обновляются с учетом цен, сравнения возможностей и рекомендаций:

Текстовые / мультимодальные модели

Возможности, цены и рекомендации по выбору для GPT, Claude, Gemini, Grok, DeepSeek, Qwen, Kimi, GLM и других.

Модели для изображений / видео

Модели для изображений, такие как Nano Banana, GPT-image, Seedream и Flux, а также модели для видео, такие как VEO, Sora и Wan — цены и использование.

Основная информация

Эндпоинты API

Основной: https://api.apiyi.com/v1
Резервный: https://vip.apiyi.com/v1

Аутентификация

Каждый запрос должен содержать ваш API Key в заголовке:

Authorization: Bearer YOUR_API_KEY

Формат запроса

Content-Type: application/json
Encoding: UTF-8
Method: POST для большинства эндпоинтов

Быстрый старт

Получите ключ API

Перейдите в консоль APIYI и войдите в систему
На странице управления token нажмите «Добавить», чтобы создать ключ API
Скопируйте сгенерированный ключ для использования в ваших запросах

Получите примеры кода на нескольких языках

В консоли есть встроенные, готовые к запуску примеры кода для многих языков, которые обновляются синхронно с последней версией API — используйте их в первую очередь:

Перейдите на страницу управления token
В строке нужного ключа API нажмите значок гаечного ключа 🔧 в столбце «Действия»
Выберите «Пример запроса», чтобы посмотреть полные примеры на cURL, Python, Node.js, Java, C#, Go, PHP, Ruby и других языках

APIYI управление token - примеры запросов

Онлайн-тестирование (Playground)

Раздел «Справочник API» предоставляет онлайн Playground: введите ваш ключ API, чтобы отправлять запросы и просматривать ответы в реальном времени напрямую — код не требуется.

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

POST /v1/chat/completions — основной чатовый и мультимодальный эндпоинт.

Список моделей

GET /v1/models — запросить доступные в настоящее время модели.

Эмбеддинги

POST /v1/embeddings — векторизация текста.

Playground для эндпоинтов генерации изображений и видео доступны на соответствующих страницах моделей (см. страницу модели image / video в разделе «Выберите модель» выше).

Минимальный пример

Самый распространенный эндпоинт — Chat Completions — скопируйте и запустите. Для дополнительных параметров и языков используйте Playground выше или «Request Example» в консоли:

Python (SDK)
cURL

from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt-5-chat-latest",
    messages=[
        {"role": "system", "content": "You are a helpful AI assistant."},
        {"role": "user", "content": "Hello! Please introduce yourself."}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)

curl -X POST "https://api.apiyi.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-chat-latest",
    "messages": [
      {"role": "system", "content": "You are a helpful AI assistant."},
      {"role": "user", "content": "Hello! Please introduce yourself."}
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  }'

Потоковый ответ

Установите stream: true в запросе, и ответ будет возвращаться по частям в виде Server-Sent Events (SSE) — идеально для вывода в стиле печатной машинки:

stream = client.chat.completions.create(
    model="gpt-5-chat-latest",
    messages=[{"role": "user", "content": "Tell a short joke"}],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content or ""
    print(content, end="", flush=True)

Каждая строка SSE начинается с data: , а финальная строка data: [DONE] сигнализирует об окончании.

Обработка ошибок

Эндпоинты соответствуют формату ошибок OpenAI:

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Распространенные коды ошибок:

Код ошибки	HTTP Status	Описание
invalid_api_key	401	Недействительный API key
insufficient_quota	429	Недостаточный баланс
model_not_found	404	Модель не существует
invalid_request_error	400	Неверные параметры запроса
rate_limit_exceeded	429	Превышен лимит запросов
server_error	500	Внутренняя ошибка сервера

Реализуйте экспоненциальный backoff: при 429 / 500 повторяйте запрос с увеличивающимися интервалами, чтобы значительно повысить стабильность. Храните ваш API Key в переменных окружения — никогда не встраивайте его в код.

Лимиты запросов

Тип лимита	По умолчанию	Описание
RPM (requests per minute)	3000	Для каждого API key
TPM (tokens per minute)	1000000	Для каждого API key
Параллельные запросы	100	Запросы, обрабатываемые одновременно

При превышении лимитов возвращается 429. Пожалуйста, соблюдайте соответствующую частоту запросов.

Нужна помощь?

Выберите модель

Рекомендации по моделям для текста / мультимодальности и цены.

Проверьте онлайн

Откройте песочницу API Reference и отправляйте запросы напрямую.

Посетите сайт: api.apiyi.com
Электронная почта технической поддержки: [email protected]

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Текстовый API

Обзор платформы

Режим совместимости с OpenAI

Поддерживаемые возможности

Поддерживается

Не поддерживается

Выберите модель

Текстовые / мультимодальные модели

Модели для изображений / видео

Основная информация

Эндпоинты API

Аутентификация

Формат запроса

Быстрый старт

Получите ключ API

Получите примеры кода на нескольких языках

Онлайн-тестирование (Playground)

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

Список моделей

Эмбеддинги

Минимальный пример

Потоковый ответ

Обработка ошибок

Лимиты запросов

Нужна помощь?

Выберите модель

Проверьте онлайн

​Обзор платформы

​Режим совместимости с OpenAI

​Поддерживаемые возможности

Поддерживается

Не поддерживается

​Выберите модель

Текстовые / мультимодальные модели

Модели для изображений / видео

​Основная информация

​Эндпоинты API

​Аутентификация

​Формат запроса

​Быстрый старт

​Получите ключ API

​Получите примеры кода на нескольких языках

​Онлайн-тестирование (Playground)

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

Список моделей

Эмбеддинги

​Минимальный пример

​Потоковый ответ

​Обработка ошибок

​Лимиты запросов

​Нужна помощь?

Выберите модель

Проверьте онлайн

Обзор платформы

Режим совместимости с OpenAI

Поддерживаемые возможности

Выберите модель

Основная информация

Эндпоинты API

Аутентификация

Формат запроса

Быстрый старт

Получите ключ API

Получите примеры кода на нескольких языках

Онлайн-тестирование (Playground)

Минимальный пример

Потоковый ответ

Обработка ошибок

Лимиты запросов

Нужна помощь?