Перейти к содержимому
API документация

О CreativeLab API

CreativeLab API — это единый программный интерфейс для генерации фото, видео и аудио всеми моделями CreativeLab (Veo, Kling, Seedance, Flux, Imagine, Image-1, Suno, YandexArt и другими) через одну точку создания задачи.

Возможности

Все модели создаются одним эндпоинтом POST /api/v2/media/tasks, а параметры конкретной модели описываются машиночитаемой схемой в GET /api/v2/media/models. Это позволяет добавлять новые модели без изменения интеграции.

Дополнительно доступны: расчёт цены до запуска (POST /api/v2/media/price), ключ идемпотентности для безопасных ретраев, доставка результата на ваш webhook и опциональное короткое синхронное ожидание (wait).

Базовый URL

https://gptunnel.ru/api/v2/media

Авторизация — заголовком Authorization (с префиксом Bearer или без него):

Authorization: YOUR_API_KEY

Как это работает

  1. (Опционально) Запросите список моделей и их параметры — GET /api/v2/media/models.
  2. (Опционально) Узнайте цену — POST /api/v2/media/price.
  3. Создайте задачу — POST /api/v2/media/tasks. В ответ приходит объект задачи с id и статусом.
  4. Получите результат одним из способов:
    • опрашивайте GET /api/v2/media/tasks/:id, пока статус не станет done или failed;
    • либо передайте webhook_url при создании — мы сами пришлём готовый объект задачи;
    • либо передайте wait: true, чтобы дождаться результата в ответе на создание (короткое ожидание).

Статусы задачи

СтатусЗначение
queuedЗадача принята и ожидает выполнения
runningИдёт генерация
doneГотово, ссылки на результат в поле result
failedОшибка генерации, детали в поле error

Что будет, если модель снимут с обслуживания

Провайдеры периодически снимают модели. У такой модели в списке моделей заполнено deprecated_at — дата снятия.

Если у неё указан аналог (deprecation_redirect_to), после этой даты задача автоматически создастся на нём — менять код не нужно. Тариф при этом не меняется: деньги списываются по той модели, которую вы запросили. О подмене сообщают заголовки ответа — в теле задачи её нет. Аналога нет — создание вернёт 410 с code: 21.

Подробнее — в разделе Устаревшие модели.

Разделы