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

Медиа модели

Медиа-модели используются для генерации изображений, видео и других медиа-результатов. Для них используется отдельная точка входа:

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.