Генерация видео через API

Эндпоинты и авторизация

Видео живёт на OpenAI-совместимом входе и работает тем же ключом, что и текстовые модели: меняется только путь. Anthropic-вход видео не генерирует.

Ключ передаётся заголовком Authorization: Bearer sk-your-tokenator-key. Отдельного ключа для видео нет — генерации списываются с того же ключа, что и токены.

Первый запрос

curl https://api.tokenator.top/v1/videos \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "prompt": "неоновый город под дождём, медленный пролёт камеры",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Ответ приходит, когда клип готов, и выглядит как обычный ответ генерации: массив data со ссылками.

{
  "created": 1755600000,
  "data": [
    { "url": "https://generated-video.tokenator.top/6f2c1a9b.mp4" }
  ]
}

В ответе ровно два поля: created — время в unix-секундах, и data — массив по числу заказанных клипов. У элемента либо url, либо b64_json — файл целиком в base64, если модель отдала видео инлайном. Ничего другого прокси в ответ не добавляет.

Ссылка ведёт на отдельный домен для файлов — generated-video.tokenator.top, прямо из корня хоста. Это не адрес API и не временная ссылка провайдера: файл скачан и перевыложен на нашей стороне, отдаётся с Cache-Control: immutable и живёт, пока лежит на диске сервиса.

Какие модели умеют видео

Тот же список отдаёт API — вместе с длительностями, разрешениями, соотношениями сторон и значениями по умолчанию. Это надёжнее, чем зашивать параметры в код: список меняется вместе с каталогом.

curl https://api.tokenator.top/v1/videos/models \
  -H "Authorization: Bearer sk-your-tokenator-key"

{
  "object": "list",
  "data": [
    {
      "id": "seedance-2.0-mini",
      "object": "video_model",
      "durations": [4, 6, 8],
      "resolutions": ["480p", "720p", "1080p"],
      "aspect_ratios": ["16:9", "9:16", "1:1"],
      "audio": true,
      "image_input": true,
      "default_duration": 4,
      "default_resolution": "720p",
      "default_aspect_ratio": "16:9",
      "cost": {
        "480p|4": 1,
        "720p|4": 2,
        "720p|8": 4,
        "1080p|8": 8
      },
      "cost_default": 2
    }
  ]
}

Параметры запроса

Незаполненные поля подставляются из значений модели по умолчанию, а значения вне заявленного списка отклоняются до обращения к провайдеру — неудачная попытка не тратит генерации. Поля callback_url, webhook_url и provider вырезаются из запроса и апстриму не уходят: обратные вызовы шли бы мимо вашего ключа.

Сколько ждать и что происходит внутри

Рендер видео занимает от десятков секунд до нескольких минут. Запрос синхронный: соединение держится, пока клип не готов, а чтобы промежуточные прокси не закрыли его по тишине, сервис досылает keep-alive прямо в тело ответа. Итоговый JSON приходит последним куском — обычный парсер прочитает его как есть.

Если провайдер отвечает асинхронной задачей, прокси сам опрашивает её статус и отдаёт готовый клип — писать свой цикл опроса не нужно. Общее ожидание ограничено 15 мин; по истечении приходит 504, списанные генерации возвращаются на ключ, а в ответе лежит job_id задачи у провайдера — рендер продолжается, и GET /v1/videos/{id}?model=… заберёт результат, когда он будет готов.

Практический вывод: поднимите таймаут HTTP-клиента до 15 мин и не ставьте ретрай по таймауту — повторный запрос запустит второй рендер.

curl "https://api.tokenator.top/v1/videos/vid_123?model=seedance-2.0-mini" \
  -H "Authorization: Bearer sk-your-tokenator-key"

Параметр model здесь обязателен по смыслу: по нему выбирается провайдер, у которого нужно спрашивать статус. Без него запрос уйдёт к первой включённой видеомодели.

Стартовый кадр и референсы

Модели, которые заявили вход изображением, умеют оживлять готовый кадр. Картинки передаются в frame_images, а референсы стиля или персонажа — в input_references; суммарно не больше четырёх на запрос. Часть моделей вместо этого принимает ссылки в reference_image_urls (до пяти), reference_videos и reference_audios (по три) — эти поля уходят на апстрим как есть, лимиты и тип ссылки проверяются на нашей стороне. Если модель вход изображением не заявляла, запрос отклоняется с 400 — до списания генераций.

Первый и последний кадр — отдельная пара полей: first_image_url и last_image_url, по одной ссылке в каждом. Клип начинается с первого кадра и приходит к последнему; можно передать только один из двух. Ссылка нужна публичная — http(s) или data:, — и она может вести куда угодно, файл необязательно загружать к нам. Модель должна заявить кадр: в каталоге у неё написано «Первый кадр: принимается», иначе 400. Разные провайдеры ждут разную форму записи — перекладывание на ту, которую понимает конкретный апстрим, делает прокси, вам достаточно этих двух полей.

{
  "model": "seedance-2.0-mini",
  "prompt": "камера медленно наезжает, ветер шевелит листву",
  "duration": 4,
  "frame_images": ["https://example.com/frame.jpg"]
}

{
  "model": "seedance-2.0-mini",
  "prompt": "плавный переход, камера не двигается",
  "duration": 5,
  "first_image_url": "https://example.com/first.jpg",
  "last_image_url": "https://example.com/last.jpg"
}

SDK и готовые примеры

Видео-эндпоинт не входит в типизированную часть OpenAI SDK, поэтому вызывать его удобнее «сырым» запросом. Ключ и базовый адрес при этом остаются теми же, что и для чата — отдельный клиент заводить не нужно.

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenator-key",
    base_url="https://api.tokenator.top/v1",
    timeout=900,
)

result = client.post(
    "/videos",
    body={
        "model": "seedance-2.0-mini",
        "prompt": "неоновый город под дождём",
        "duration": 6,
        "resolution": "720p",
    },
    cast_to=dict,
)

print(result["data"][0]["url"])

import requests

response = requests.post(
    "https://api.tokenator.top/v1/videos",
    headers={"Authorization": "Bearer sk-your-tokenator-key"},
    json={
        "model": "seedance-2.0-mini",
        "prompt": "неоновый город под дождём",
        "duration": 6,
        "resolution": "720p",
    },
    timeout=900,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])

const response = await fetch("https://api.tokenator.top/v1/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-your-tokenator-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0-mini",
    prompt: "неоновый город под дождём",
    duration: 6,
    resolution: "720p",
  }),
  signal: AbortSignal.timeout(900_000),
})

const result = await response.json()
console.log(result.data[0].url)

Готовые фрагменты под ваш ключ и адрес есть в дашборде ключа — там же, где сниппеты для чата.

Как списывается видео

Видео не тратит токены. У ключа есть отдельный счётчик генераций видео, и одна генерация — это один клип базового разрешения и базовой длительности. Более тяжёлые параметры стоят кратно дороже: множитель по разрешению задаёт оператор (например 480p — 1×, 720p — 2×, 1080p — 4×), а длительность масштабируется относительно базовой. Итоговое списание — число клипов × множитель модели × множитель разрешения × множитель длительности, округлённое вверх.

Считать цену руками не нужно: /v1/videos/models отдаёт по каждой модели поле cost — список объектов {"resolution", "seconds", "price"}, по одному на каждое сочетание параметров (и с aspect_ratio, если соотношение сторон меняет цену), плюс cost_default для параметров по умолчанию. Если разрешение задано через size, цена считается по короткой стороне: 1920x1080 — это 1080p.

Генерации резервируются до обращения к провайдеру и возвращаются, если клип не приехал: неудачный рендер ничего не стоит. Пакеты видео продаются отдельно от токенов; ключ с token_limit: -1 — это ключ только под генерацию, текстовые модели ему недоступны.

curl https://api.tokenator.top/v1/tokens \
  -H "Authorization: Bearer sk-your-tokenator-key"

{
  "name": "my-key",
  "limit": 1000000,
  "used": 240000,
  "remaining": 760000,
  "image_limit": 0,
  "image_used": 0,
  "image_remaining": 0,
  "video_limit": 20,
  "video_used": 3,
  "video_remaining": 17
}

Ограничения

• Один клип за запрос: n больше 1 обрезается до 1.
• Длительность клипа — не больше 60 секунд, и не больше того, что заявила модель.
• Не больше четырёх входных изображений на запрос (frame_images и input_references вместе).
• Референсов — до пяти изображений (reference_image_urls), до трёх видео и до трёх аудио. Ссылки должны быть http(s) или data:; всё остальное отклоняется с 400 до списания генераций.
• Часть моделей вообще не рисует по одному описанию: у них в каталоге стоит «Референс: обязателен», и запрос без reference_image_urls / reference_videos / frame_images отклоняется с 400 сразу, без обращения к провайдеру.
• Одновременных генераций на ключ: 1. Пятый запрос не встаёт в очередь, а сразу получает 429 с полем busy_for_seconds.
• Общее ожидание одного запроса ограничено 15 мин.

Ошибки

Попробовать без кода

В дашборде ключа есть «Студия» с переключателем «Картинки / Видео»: длительность, разрешение и соотношение сторон выбираются кнопками, готовые клипы складываются в галерею. Это тот же эндпоинт и тот же счётчик генераций — удобно, чтобы проверить модель до того, как писать интеграцию.

Частые вопросы

Читайте дальше