Wan 3.0 Prime API: руководство на китайском: текст в видео, начальный и конечный кадры, видео по референсу

TL;DR

• Wan 3.0 Prime (Wanxiang 3.0 ускоренная версия) — это быстрый маршрут Wan 3.0 от Alibaba, имя модели wan3.0-video-prime. Одна модель умеет делать текст в видео, видео по начальному и конечному кадрам и видео по референсу; референсными материалами могут быть изображения, аудио и даже документ или веб-страница. Один ролик длится 2–30 секунд, по умолчанию со звуком. Откройте страницу модели — и можно генерировать онлайн.
• Оплата по секундам: 480P — $0.0875 за секунду, 720P — $0.18, 1080P — $0.36. 5 секунд в 480P стоят всего $0.4375.
• Два подводных камня: разрешение нужно писать заглавными буквами 480P / 720P / 1080P, и по умолчанию используется 1080P; Prime не принимает референсные видео.

Сначала посмотрите результат

Текст в видео, 480P, 5 секунд, со звуком (если включить звук, слышны шум дождя, поток машин и шипение гриля):

Rain streaking down a narrow neon-lit alley at night; a slow dolly-forward past
steaming street-food stalls, magenta and cyan reflections rippling in the wet
pavement, a tabby cat darting between crates mid-shot. Ambient sound: steady
rain, distant traffic hiss, the sizzle of a grill and a low synth drone.

Сгенерировать с этим промптом → (5 секунд, 480P, 16:9, звук включён)

wan3.0-video-prime, 480P, 5 секунд, со звуком, $0.4375.

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

Bring the referenced ceramic fox figurine to life: it slowly turns its head
toward camera, blinks, and tilts with a curious expression; subtle idle
breathing, a light breeze stirring the tiny scarf, soft studio key light on a
clean seamless backdrop, smooth loopable motion.

Сгенерировать с этим промптом → (загрузите своё референсное изображение, 5 секунд, 480P, 9:16)

wan3.0-video-prime, референсное изображение, 480P, 5 секунд, 9:16, $0.4375.

curl: первое видео

5 секунд 480P, $0.4375:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，镜头缓慢推近，暖色调",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

После получения data.taskId запросите GET /v1/tasks/{taskId}, дождитесь status = success, затем скачайте output[0].url.

Python: отправка, опрос, скачивание

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    r = requests.post(API, json={"model": "wan3.0-video-prime", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 参考生视频：让参考图里的产品动起来，480P 5 秒（$0.4375）
url = generate(
    prompt="让参考图里的香水瓶在黑色大理石上缓慢旋转，侧逆光扫过瓶身，镜头缓慢推近",
    reference_image_urls=["https://your-cdn.example.com/perfume.jpg"],
    resolution="480P", duration=5, aspect_ratio="9:16", audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Три способа использования

Способ	Что передавать	Описание
Текст в видео	Только prompt
Начальный и конечный кадры	first_frame_url, можно добавить last_frame_url	Нельзя использовать одновременно с референсными материалами
Видео по референсу	reference_image_urls (до 10 штук), reference_audio_urls (до 5 фрагментов, использовать вместе с изображениями), reference_file_urls или reference_link_urls (по 1 максимум, одно из двух)	В промпте ссылайтесь на материалы по порядку как Image1, Audio1

Референсные документы и веб-страницы — особенность Wan 3.0: можно передать модели PDF с брендбуком или ссылку на страницу товара, и она снимет видео по информации из них. Веб-страница должна открываться без входа в аккаунт.

Обзор параметров

Параметр	Значения	Описание
prompt	Строка, обязательно	Опишите сцену, действие, камеру, свет и звук
resolution	480P / 720P / 1080P, по умолчанию 1080P	Заглавными, напрямую определяет цену
duration	Целое число 2–30, по умолчанию 5	В секундах
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16, по умолчанию adaptive	adaptive выбирает автоматически по материалам и промпту
audio	По умолчанию true	Синхронная звуковая дорожка, без дополнительной платы
seed	0–2147483647	Фиксированное зерно для воспроизводимости
first_frame_url / last_frame_url	Адрес изображения	Начальный и конечный кадры
reference_image_urls и др.	См. таблицу выше	Видео по референсу

Посчитаем стоимость

Длительность	480P ($0.0875/сек)	720P ($0.18/сек)	1080P ($0.36/сек)
5 секунд	$0.4375	$0.90	$1.80
10 секунд	$0.875	$1.80	$3.60
30 секунд	$2.625	$5.40	$10.80

Сначала отлаживайте промпт в 480P, а когда всё готово, переходите на 720P или 1080P. Если не спешите, стандартная версия Wan 3.0 (wan3.0-video) в 720P стоит всего $0.08 за секунду и принимает референсные видео. Полные цены см. в Цены Wan 3.0 Prime API.

Перед запуском в продакшен

• Используйте callback вместо опроса: на верхнем уровне запроса (на том же уровне, что и input) добавьте "callback": {"url": "https://ваш-домен/hiapi/callback"} и дедуплицируйте по taskId.
• Своевременно сохраняйте: output[0].url — временная ссылка.
• Повторяйте с ключом идемпотентности: добавьте в заголовки Idempotency-Key, повтор с тем же ключом создаст задачу только один раз.
• Автоматический возврат при сбое: оплата только за успешно сгенерированные видео.

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

Почему при передаче 720p возникает ошибка?

Разрешение нужно писать заглавными буквами. При передаче строчными вернётся 400: resolution: value must be one of '480P', '720P', '1080P'.

Можно ли передать референсное видео?

Prime не может, он не принимает параметр reference_video_urls. Если нужно референсное видео, переходите на стандартную версию Wan 3.0 wan3.0-video.

Можно ли отключить звук?

Да, audio: false. По умолчанию включён, цена не меняется.

Чем Prime отличается от стандартной версии Wan 3.0?

Параметры и характеристики вывода одинаковые, Prime — ускоренный маршрут; у стандартной версии тоже есть режим 480P ($0.04/сек), но 720P и 1080P стоят более чем в два раза дороже за секунду и не принимают референсные видео.

Больше о написании промптов см. в Примеры промптов Wan 3.0 Prime, а сравнение с предыдущим поколением — в Как выбрать между Wan 3.0 и Wan 2.7. Также можно сразу перейти на страницу модели и сгенерировать этот ролик с дождливым переулком.