Описание API
CDNvideo AI Hub предоставляет единую точку входа сразу для нескольких популярных интерфейсов:
- OpenAI-совместимый API —
/chat/completionsдля всех текстовых моделей и/responsesдля gpt-5 и новее. - Anthropic-совместимый API —
/messagesдля моделей Claude (например,claude-opus-4.7). - Медиа-маршруты —
/media/...для изображений и видео.
Если ваш код уже использует OpenAI или Anthropic SDK, обычно достаточно заменить base_url, передать секретный ключ и указать нужную модель в поле model. Это же правило работает для внешних инструментов вроде Cursor, Continue, Zed, Open WebUI, LangChain, n8n и других клиентов, которые поддерживают /chat/completions, /responses или /messages.
Общие понятия
- Base URL:
https://api.cdnvideo.ru/app/aihub-router/v1 - Секретный ключ:
sk-..., полученный в личном кабинете - Авторизация: заголовок
Authorization: Bearer {sk}во всех запросах - Модель: название модели в поле
model, напримерgpt-5.5 - Media Base URL:
https://api.cdnvideo.ru/app/aihub-router/v1/mediaдля медиа-моделей
Храните ключ безопасно
Не публикуйте секретный ключ в коде, логах, репозиториях и клиентских приложениях. Передавайте его через переменные окружения или секреты вашей инфраструктуры.
Список доступных моделей
Чтобы узнать, какие модели доступны вашему пользователю или API-ключу, выполните запрос GET /models:
curl https://api.cdnvideo.ru/app/aihub-router/v1/models \
-H "Authorization: Bearer ${AIHUB_API_KEY}"
Ответ содержит массив моделей. Значение поля id — это название модели, которое нужно передавать в поле model для текстовых запросов или в заголовке X-Model для медиа-моделей.
{
"data": [
{
"id": "gpt-5.5",
"created": "1704038400",
"object": "model",
"owned_by": "system"
},
{
"id": "claude-opus-4.8",
"created": "1704038400",
"object": "model",
"owned_by": "system"
}
]
}
Как подключиться
Если вы используете официальный OpenAI SDK, укажите base_url CDNvideo AI Hub и передайте секретный ключ:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIHUB_API_KEY"],
base_url="https://api.cdnvideo.ru/app/aihub-router/v1",
)
Если вы отправляете HTTP-запросы напрямую, добавляйте заголовки:
Authorization: Bearer {AIHUB_API_KEY}
Content-Type: application/json
Разделы API-документации
- Ключи API — как получить секретный ключ и передавать его в запросах.
- Текстовые модели — методы
/chat/completions,/responses(OpenAI) и/messages(Anthropic). - Медиа модели — генерация изображений, видео и других медиа-результатов через
/media/.... - Интеграции — готовые конфиги для Codex, Claude Code и других CLI-инструментов.
Быстрый чек-лист
- Получите
sk-...в личном кабинете. - Проверьте доступные модели через
GET /modelsи возьмите нужное название из поляid. - Укажите
base_url:https://api.cdnvideo.ru/app/aihub-router/v1. - Передайте заголовок
Authorization: Bearer {sk}. - В теле запроса задайте
model, напримерgpt-5.5. - Используйте привычный OpenAI-совместимый интерфейс.
- Для медиа-моделей используйте
base_url:https://api.cdnvideo.ru/app/aihub-router/v1/mediaи передавайте модель в заголовкеX-Model.