Медиа модели
Медиа-модели используются для генерации изображений, видео и других медиа-результатов. Для них используется отдельная точка входа:
https://api.cdnvideo.ru/app/aihub-router/v1/media
Этот URL можно использовать как base_url для запросов к медиа-моделям. После /media указывается путь конкретного маршрута модели:
{base_url}/media/{custom_path}
Например, это могут быть OpenAI-совместимые или кастомные маршруты:
/media/images/generations— OpenAI-совместимый маршрут генерации изображений, например дляgpt-image-2илиgpt-image-1./media/kling/images/generations— маршрут создания асинхронной задачи Kling для генерации изображений./media/kling/images/generations/{taskId}— получение статуса и результата задачи Kling./media/seedream/image/generations— маршрут генерации и редактирования изображений Seedream./media/tob/diffusion— маршрут создания асинхронной задачи midjourney./media/tob/job/{jobId}— получение статуса и результата задачи midjourney./media/videos— маршрут создания асинхронной video-задачи sora-2./media/videos/{video_id}— получение статуса video-задачи sora-2./media/videos/{video_id}/content— скачивание готового видео sora-2./media/kling/videos/text2video— маршрут создания асинхронной text-to-video задачи kling-3.0-video./media/kling/videos/text2video/{taskId}— получение статуса и результата text-to-video задачи kling-3.0-video./media/seedance/contents/generations/tasks— маршрут создания и просмотра video-задач Seedance./media/seedance/contents/generations/tasks/{id}— получение, отмена или удаление задачи Seedance./media/happyhorse/v1/video-synthesis— единый маршрут создания video-задачи HappyHorse./media/happyhorse/v1/tasks/{taskId}— получение статуса и результата задачи HappyHorse./media/hailuo/video/generate— маршрут создания асинхронной video-задачи HaiLuo./media/hailuo/video/task/{taskId}— получение статуса иfileIdзадачи HaiLuo./media/hailuo/video/file— получение URL готового видео HaiLuo./media/...— другие пути для Kling, GPT Image, Seedream и будущих медиа-моделей.
Пути медиа-моделей
Точный путь после /media зависит от выбранной модели и её способа взаимодействия. Например, GPT Image может использовать OpenAI-совместимый путь /images/generations, Kling для изображений — асинхронные ручки /kling/images/generations, sora-2 — /videos, kling-3.0-video — /kling/videos/text2video, Seedance — /seedance/contents/generations/tasks, Happy Horse — /happyhorse/v1/*, Seedream — /seedream/image/generations, midjourney — асинхронные ручки /tob/diffusion, /tob/inpaint, /tob/upscale и /tob/job/{jobId}, а HaiLuo — video-ручки /hailuo/video/*.
Взаимодействие с медиа-моделями
Для медиа-моделей сохраняется тот же принцип авторизации: используется секретный ключ sk-... в заголовке Authorization.
Модель для маршрутизации передаётся в заголовке X-Model:
X-Model: gpt-image-2
Пример: GPT Image через curl
Интерфейс GPT Image работает с моделями gpt-image-1 и gpt-image-2. Для выбора нужной модели укажите её название в заголовке X-Model.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/images/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: gpt-image-2" \
-d '{
"prompt": "A minimalistic product photo of a white sneaker on a blue background",
"size": "1024x1024"
}'
Пример: GPT Image через OpenAI SDK
Для OpenAI-совместимого интерфейса GPT Image можно использовать официальный OpenAI SDK и указать media base_url:
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/media",
)
image = client.images.generate(
prompt="A minimalistic product photo of a white sneaker on a blue background",
size="1024x1024",
extra_headers={"X-Model": "gpt-image-2"},
)
Такой же подход можно использовать для gpt-image-1, изменив значение заголовка X-Model.