К содержимому
Блог

Seedance 2.0 и 2.5: первый ролик через API Relay

Seedance 2.0 и 2.5: первый ролик через API Relay

Для первого ролика через API Relay выберите seedance-2.0 или seedance-2.5, опишите одну сцену и отправьте запрос на /v1/videos. API сразу возвращает ID задачи со статусом queued. Опросите задачу до completed, затем сразу скачайте MP4: задача хранится 30 минут после создания.

Как выбрать Seedance 2.0 или 2.5

Откройте каталог видео и карточку модели. seedance-2.0 принимает длительность 5 или 10 секунд и размеры 480p, 720p, 1080p или 4K. seedance-2.5 принимает длительность от 4 до 30 секунд и размеры 480p, 720p или 1080p.

Seedance 2.00,225 $ за секунду видео
Seedance 2.50,425 $ за секунду видео

В примере ниже используется seedance-2.5, пять секунд и 720p. Подготовьте одну сцену: «Белая чашка на деревянном столе. Над чашкой поднимается пар. Камера неподвижна, мягкий дневной свет». Монтаж, несколько локаций и точные титры оставьте для следующей попытки.

Как создать и скачать ролик в Python

Сохраните пример в отдельный файл и задайте ключ в окружении процесса. Скрипт отправляет POST только один раз, печатает ID задачи и продолжает опрос после перезапуска, если ID сохранён отдельно.

bash
export RELAY_API_KEY="sk-demo-not-a-real-key"
python
import json
import os
import time
from pathlib import Path
from urllib.request import Request, urlopen

base = "https://relay-llm.ru/v1"
headers = {"Authorization": f"Bearer {os.environ['RELAY_API_KEY']}"}

def read_json(method, path, body=None):
    request_headers = dict(headers)
    data = None
    if body is not None:
        request_headers["Content-Type"] = "application/json"
        data = json.dumps(body, ensure_ascii=False).encode("utf-8")
    request = Request(base + path, data=data, headers=request_headers, method=method)
    with urlopen(request, timeout=60) as response:
        return json.load(response)

job = read_json("POST", "/videos", {
    "model": "seedance-2.5",
    "prompt": "Белая чашка на деревянном столе. Над чашкой пар. Камера неподвижна, мягкий дневной свет.",
    "seconds": 5,
    "size": "720p",
})
job_id = job["id"]
print("job_id:", job_id, flush=True)

for attempt in range(120):
    job = read_json("GET", f"/videos/{job_id}")
    state = job["status"]
    if state == "completed":
        request = Request(base + f"/videos/{job_id}/content", headers=headers)
        with urlopen(request, timeout=60) as response:
            Path("video.mp4").write_bytes(response.read())
        break
    if state == "failed":
        raise RuntimeError(json.dumps(job.get("error"), ensure_ascii=False))
    if state not in ("queued", "in_progress"):
        raise RuntimeError(f"Unexpected status: {state}")
    time.sleep(5)
else:
    raise TimeoutError(f"Polling stopped; check existing job {job_id}")

У seedance-2.5 пять секунд и 720p входят в опубликованные варианты. Пауза опроса, число попыток и сетевой тайм-аут принадлежат скрипту, а не ограничениям Relay. Перед рабочим запуском сверьте версию модели, длительность и размер в карточке.

Как читать статус и получить файл

После POST задача имеет статус queued. При опросе возможны queued, in_progress, completed и failed. Новую генерацию не отправляйте, пока есть ID существующей задачи.

После completed вызовите GET /v1/videos/{id}/content с тем же ключом. Ответ содержит MP4 и поддерживает HTTP Range, поэтому клиент может продолжить частично скачанный файл. Сохраните результат сразу: через 30 минут после создания задачи он больше не доступен.

Что делать при остановке или ошибке

Если программа остановила опрос, задача может продолжать выполняться. Проверьте её по сохранённому ID, прежде чем создавать новую. Если соединение оборвалось при первоначальном POST и ID не получен, сначала проверьте журнал: автоматический повтор способен создать ещё одну генерацию.

При 401 проверьте ключ, при 402 прочитайте код отказа. При 429 выдержите паузу по правилам лимитов. Для разбора сохраните HTTP-статус и x-request-id, если он получен; рабочий секрет в отчёт не включайте.

Как оценить ролик и расход

Посмотрите файл целиком. Проверьте, сохранилась ли чашка, движется ли пар и не двигается ли камера вопреки запросу. Если нарушен один пункт, меняйте соответствующую часть промпта; одновременная смена сцены и модели не покажет причину различия.

Видео оплачивается за секунды готового ролика по цене модели. Задача со статусом failed не оплачивается, а технически успешный ролик, который вам не понравился, остаётся выполненной генерацией. В бюджет включайте такие попытки и смотрите итог в журнале запросов.

Какую Seedance выбрать для первого ролика?

Для короткой пробы возьмите seedance-2.5 с пятью секундами и 720p. Если нужен ролик на 10 секунд или 4K, проверьте seedance-2.0 и её карточку.

Почему вместо видео пришёл ID?

API создал асинхронную задачу. Проверяйте статус по ID и скачайте файл после completed, не отправляя генерацию заново.

Когда скачивать готовый ролик?

Сразу после completed. Задача и файл доступны 30 минут после создания.

Что делать, если опрос закончился, а видео ещё нет?

Продолжите проверку существующей задачи по сохранённому ID. Лимит ожидания клиента не означает отмену генерации.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.