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

Create Wan Video: создать задачу и скачать ролик через API

Create Wan Video: создать задачу и скачать ролик через API

Create Wan Video через Relay означает три действия: создать задачу для wan-3-0, дождаться completed и скачать MP4 через /content. POST не возвращает готовый файл. Ниже Python-скрипт с ограниченным ожиданием и сохранением ID: если соединение оборвалось после создания, можно продолжить проверку задачи, не оплачивая новый запуск по ошибке.

Как выполнить Create Wan Video через Relay

Откройте каталог видео и найдите Wan 3.0 с публичным ID wan-3-0. Проверьте доступность, параметры и цену перед запуском. В запросе нужно точное значение, а не написанное произвольно название семейства. Эта статья показывает генерацию по тексту; дополнительные режимы и параметры нельзя выводить из названия модели.

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

Опишите одну сцену. Укажите предмет, действие и движение камеры. Если нужен монтаж из нескольких эпизодов, сначала создайте отдельные клипы и соберите их в редакторе. Фразы «динамично» и «кинематографично» сами по себе не определяют, что именно должно двигаться в кадре.

Как создать задачу и дождаться файла в Python

Скрипт использует стандартную библиотеку Python, сторонние SDK не нужны. Перед запуском задайте RELAY_API_KEY со своим секретом. Для документационного примера допустимо только вымышленное значение:

bash
export RELAY_API_KEY="sk-demo-not-a-real-key"

Сохраните код в wan.py, выполните python3 wan.py. Он создаёт один ролик и ждёт не дольше выбранного для примера интервала. Число 1200 здесь ограничивает ожидание клиента, а не описывает скорость или лимит модели.

python
import json
import os
import time
from pathlib import Path
from urllib.request import Request, urlopen

base = "https://relay-llm.ru/v1"
key = os.environ["RELAY_API_KEY"]

def get_json(path, payload=None):
    headers = {"Authorization": f"Bearer {key}"}
    data = None
    if payload is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
    request = Request(base + path, data=data, headers=headers)
    with urlopen(request, timeout=60) as response:
        return json.load(response)

job = get_json("/videos", {
    "model": "wan-3-0",
    "prompt": "Керамическая чашка целиком на столе, камера медленно отъезжает, мягкий утренний свет, без надписей",
})
video_id = job["id"]
Path("wan-job.json").write_text(json.dumps(job), encoding="utf-8")
print("ID задачи:", video_id, flush=True)
deadline = time.monotonic() + 1200
while time.monotonic() < deadline:
    state = get_json(f"/videos/{video_id}")["status"]
    if state == "completed":
        request = Request(
            base + f"/videos/{video_id}/content",
            headers={"Authorization": f"Bearer {key}"},
        )
        with urlopen(request, timeout=120) as response:
            content = response.read()
        if not content:
            raise ValueError("Получен пустой файл")
        Path("wan.mp4").write_bytes(content)
        print("Сохранён wan.mp4")
        break
    if state == "failed":
        raise RuntimeError(f"Задача {video_id} завершилась ошибкой")
    if state not in {"queued", "in_progress"}:
        raise RuntimeError(f"Неизвестный статус: {state}")
    time.sleep(5)
else:
    raise TimeoutError(f"Ожидание закончено; проверьте задачу {video_id}")

В минимальном теле только model и prompt. Если задаче нужны длительность и размер, возьмите поля и допустимые значения из карточки модели и документации видео. Число секунд в тексте промпта не заменяет параметр API.

Скрипт сохраняет ID до первого опроса и не повторяет POST. Файл wan-job.json не содержит ключ. Сохраните его вместе с исходным промптом: он позволяет найти конкретную попытку и продолжить опрос отдельным GET.

Что означают статусы видеозадачи

СтатусЧто делать приложению
queuedЖдать и повторить GET с паузой
in_progressПродолжить ожидание, не создавать новый ролик
completedСкачать /v1/videos/{id}/content с авторизацией
failedОстановить опрос и разобрать неудачную попытку

Неизвестное значение обрабатывайте как ошибку, а не успех. При сетевой ошибке GET можно продолжить чтение того же ID после восстановления соединения. При ошибке POST без полученного ID исход может быть неопределённым: сохраните x-request-id, время и обратитесь в поддержку до повторного создания.

Доступ к задаче ограничен по времени от её создания. Не ждите следующего дня для скачивания и не используйте /content как постоянный адрес в плеере. Перенесите MP4 в своё хранилище сразу после готовности. Закрытие вкладки или завершение скрипта само по себе не отменяет генерацию.

Как проверить ролик и расход

Откройте MP4 целиком. Сравните действие и движение камеры с промптом, проверьте края предмета, случайные надписи, лишние объекты и резкие изменения формы. Если нужен определённый формат кадра или длительность, проверьте свойства файла отдельно. Успешное скачивание не доказывает соответствие брифу.

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

Посмотрите фактическую запись в журнале Relay. Для оценки серии сложите все её расходы и разделите на число принятых роликов. При отсутствии принятых результатов цену успешного ролика считать рано. Ограничьте число попыток и лимит ключа до запуска, а не после незаметного цикла генерации.

Как исправлять ошибки без лишнего POST

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

Для обращения сохраните модель, ID задачи, HTTP-статус, время и x-request-id. Не пересылайте Authorization и реальный ключ. Коды ошибок Relay разобраны в справочнике.

Create Wan Video возвращает MP4 сразу после запроса?

Нет. POST создаёт задачу. Получите её ID, дождитесь completed и скачайте содержимое отдельным запросом с ключом.

Что делать после таймаута скрипта?

Используйте ID из wan-job.json и проверьте статус той же задачи. Не запускайте wan.py заново без проверки: скрипт создаст ещё один ролик.

Можно ли хранить ссылку /content вместо файла?

Это временный доступ к результату задачи, а не файловое хранилище. Скачайте готовый MP4 и разместите в своём хранилище.

Создать аккаунт для Wan Video

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