Перейти к содержанию

Описание 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.