Alibaba: Wan 2.6
Alibaba Wan 2.6 генерирует видео с синхронизированным звуком по тексту, начальному изображению или визуальным референсам. Режимы разработчика поддерживают MP4 в 720p или 1080p: 2–15 секунд для генерации по тексту/изображению и 2–10 секунд по референсам. Процесс отличается управлением типом плана и референсами с индексами персонажей.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Alibaba Wan 2.6 — семейство генерации видео с отдельными профилями по тексту, первому кадру и референсам. Разработчик документирует синхронизированный звук и истории из нескольких планов. Текст сцены превращается в клип, подготовленное изображение задаёт начало, а визуальные референсы направляют персонажей и предметы в новой сцене. Полезный результат — готовое короткое видео со звуком для проверки или включения в монтажную последовательность.
Для генерации по тексту опишите объект, окружение, движение, камеру и звук. Прежнее руководство 2.6 принимает китайские или английские промпты до 1 500 символов и отдельный негативный промпт до 500 символов; более длинный текст обрезается. Например, в товарной анимации игрушечный фургон доставки пересекает верстак, останавливается у маленькой посылки, а план заканчивается на посылке с тихим механическим звуком остановки. Сохраняйте последовательность достаточно простой, чтобы главное действие легко оценивалось.
Управление несколькими планами — особенность процесса 2.6. Текстовое руководство разработчика предлагает shot_type со значениями single или multi, по умолчанию single. В этом текстовом режиме настройка действует при включённом переписывании промпта и имеет приоритет над противоречащими словами задания. Согласуйте описания планов и тайминга с выбранным значением. Более позднее руководство Wan 2.7 интерпретирует структуру непосредственно из промпта, поэтому такая новая подготовка не должна незаметно заменять документированные настройки этой версии.
Генерация по первому кадру использует изображение для начала и промпт для описания продолжения. Подготовьте нужное кадрирование, объект и визуальные детали в изображении до запроса движения. В сравнении разработчика первый/последний кадры и продолжение исходного клипа обозначены как дополнения процесса по изображениям 2.7, а не настройки профиля первого кадра 2.6. Для товарной анимации проверяйте предмет на протяжении всего движения и оценивайте пригодность формы, маркировки и сцены для задуманного плана.
Текущий прежний референсный API 2.6 принимает изображения и видео упорядоченным списком. Допускает до пяти изображений и трёх видео при суммарном пределе пять файлов. Каждый референс должен содержать один объект. Первый соответствует character1, второй — character2 и далее; используйте эти идентификаторы в промпте вместо меток типов Wan 2.7. Ясно опишите действия и реплики каждого персонажа, чтобы проверить принадлежность действий и идентичность во взаимодействии нескольких персонажей.
Руководство по референсам перечисляет JPEG/JPG, PNG без прозрачности, BMP и WEBP до 20 МБ, с каждой стороной от 240 до 8 000 пикселей. Референсное видео может быть MP4 или MOV до 100 МБ; текущее поле reference_urls принимает видео длительностью от одной до тридцати секунд. У устаревшего поля только для видео другая минимальная длительность и иные требования подготовки. Выберите исходный фрагмент и объект, влияющие на сцену, и явно обозначьте роли референсов. Даже узнаваемый персонаж может быть неправильно размещён или озвучен в результате.
Генерация по тексту поддерживает предоставленное аудио через документированное поле аудиоисточника, а режимы результата включают звук, синхронизированный с изображением. Задайте нужный диалог, исполнение и атмосферу в задании, затем проверяйте фактические слова и эффекты. Необязательный переключатель звука референсного API отдельно помечен для разновидности Flash; нельзя считать его универсальным отключением звука для любого режима 2.6. И звук, и изображение требуют проверки относительно задуманной сцены.
Текущие спецификации разработчика указывают 720p и 1080p, от двух до пятнадцати секунд для генерации по тексту/изображению и от двух до десяти секунд по референсам. Видеоруководства описывают MP4 с частотой 30 кадров/с, а референсный API выбирает явные ширину и высоту вместо одного обозначения соотношения сторон. Горизонтальные, вертикальные и квадратные варианты имеют собственные документированные размеры. Сохраняйте правила длительности и размера выбранного режима вместе с заданием, не заимствуя тридцатисекундный предел Wan 3.0 или адаптивные настройки другой версии.
Генерация обрабатывается как задача; успешный результат содержит адрес видео. Разработчик документирует срок действия ссылок двадцать четыре часа. Сохраните сам клип, исходные референсы и промпт для проверки при монтаже. Фиксированный seed помогает сравнивать запросы, но прежнее руководство прямо предупреждает, что он не гарантирует одинаковых результатов. Проверяйте непрерывность, идентичность референсов, контакт объектов, запрошенную структуру планов, диалог и видимые детали. Следующая правка должна устранять конкретную найденную проблему, сохраняя удачное направление плана.
Ailoot Ultra · Видео POST /v1/videos alibaba/wan-2.6
alibaba/wan-2.6Начало
Alibaba Wan 2.6 генерирует видео с синхронизированным звуком по тексту, начальному изображению или визуальным референсам. Режимы разработчика поддерживают MP4 в 720p или 1080p: 2–15 секунд для генерации по тексту/изображению и 2–10 секунд по референсам. Процесс отличается управлением типом плана и референсами с индексами персонажей.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Видео POST /v1/videos
- Входные данные
text,image- Результат
video- Выходной формат
- Исходные байты MP4; без нормализации и перекодирования
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения alibaba/wan-2.6 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеduration | Типinteger | ТребованиеОбязательно | Значения и ограничения 5, 10 Минимум: 1 Максимум: 600 | По умолчанию— |
Полеresolution | Типstring | ТребованиеНеобязательно | Значения и ограничения 720p, 1080p | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 16:9, 9:16 | По умолчанию— |
Полеgenerate_audio | Типboolean | ТребованиеНеобязательно | Значения и ограничения false, true | По умолчанию— |
Полеframe_images | Типarray | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 1 Максимум элементов: 1 Входное содержимое: Массив объектов кадров. Каждый объект содержит type=image_url, image_url с url и frame_type. Используйте HTTPS URL изображения и укажите first_frame в frame_type. Каждая роль кадра встречается не более одного раза. Точные ключи: type, image_url, frame_type Условия: Эти ключи описывают каждый объект кадра; image_url содержит только url. Не передавайте frame_images для запроса только с текстом. | По умолчанию— |
Полеinput_references | Типarray | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеsize | Типstring | ТребованиеНеобязательно | Значения и ограничения 1280x720, 1080x1920, 720x1280, 1920x1080 Шаблон: ^[1-9][0-9]*x[1-9][0-9]*$ | По умолчанию— |
Полеseed | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: -9 223 372 036 854 775 808 Максимум: 9 223 372 036 854 775 807 | По умолчанию— |
Полеcallback_url | Типstring | ТребованиеНеобязательно | Значения и ограничения Шаблон: ^https:// | По умолчанию— |
Полеsession_id | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеtrace | Типobject | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеuser | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Сочетания входных материалов
Из текста в видео · Текстовый запрос. · Обязательно: model, prompt, duration
Передайте prompt как текст, а duration — как целое число секунд. Выберите поддерживаемое разрешение; добавьте соотношение сторон или используйте размер из списка.
model: Тип: string · alibaba/wan-2.6
prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да
Из изображения в видео · Текстовый запрос и изображение первого кадра. · Обязательно: model, prompt, duration, frame_images
frame_images — массив. Каждый объект кадра содержит type, image_url и frame_type; image_url содержит url. Укажите image_url в type. Используйте first_frame. Каждая роль кадра встречается не более одного раза. Для каждого кадра укажите публичный HTTPS URL изображения. Выберите поддерживаемое разрешение; добавьте соотношение сторон или используйте размер из списка.
Точные ключи: type, image_url, frame_type
model: Тип: string · alibaba/wan-2.6
prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, duration |
Параметрmaterial_types | Контрактtext, image |
Параметрadditional_properties | Контрактfalse |
Параметрoptional_controls | Контрактresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Жизненный цикл: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Компонент платы | Разрешение референса | Режим референса | Расчётная единица | Условия расчёта | Плата |
|---|---|---|---|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Компонент платы— | Разрешение референса— | Режим референса— | Расчётная единица— | Условия расчёта— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Компонент платы— | Разрешение референса— | Режим референса— | Расчётная единицаза секунду видео | Условия расчётарежим генерации: image_to_video; разрешение: 1080p | Плата Выход · Цена видео · Оценка только для сравнения $0.3 за секунду видео |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Компонент платы— | Разрешение референса— | Режим референса— | Расчётная единицаза секунду видео | Условия расчётарежим генерации: image_to_video; разрешение: 720p | Плата Выход · Цена видео · Оценка только для сравнения $0.2 за секунду видео |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Компонент платы— | Разрешение референса— | Режим референса— | Расчётная единицаза секунду видео | Условия расчётарежим генерации: text_to_video; разрешение: 1080p | Плата Выход · Цена видео · Оценка только для сравнения $0.24 за секунду видео |
| КонфигурацияВидео из текста · 480p · Справочная ставка | Шкала ставок— | Прогноз количества— | Компонент платыreference_output_rate | Разрешение референса480p | Режим референсаИз текста в видео | Расчётная единицаза секунду результата | Условия расчёта— | Плата Выход · Справочный тариф за секунду выходного видео · Оценка только для сравнения $0.08 за секунду результата |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Компонент платы— | Разрешение референса— | Режим референса— | Расчётная единицаза секунду видео | Условия расчётарежим генерации: text_to_video; разрешение: 720p | Плата Выход · Цена видео · Оценка только для сравнения $0.16 за секунду видео |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Компонент платы— | Разрешение референса— | Режим референса— | Расчётная единица— | Условия расчёта— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.8 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Сведения о справочном тарифе
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
Ссылки на цены конфигураций видео
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияЦена видео | Условия расчётарежим генерации: text_to_video; разрешение: 480p | Плата Выход · Цена видео $0.08 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётарежим генерации: text_to_video; разрешение: 720p | Плата Выход · Цена видео $0.16 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётарежим генерации: image_to_video; разрешение: 720p | Плата Выход · Цена видео $0.2 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётарежим генерации: text_to_video; разрешение: 1080p | Плата Выход · Цена видео $0.24 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётарежим генерации: image_to_video; разрешение: 1080p | Плата Выход · Цена видео $0.3 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
Примеры запросов
Ailoot Ultra · Видео
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":5,"model":"alibaba/wan-2.6","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Получить и сохранить результаты
Ailoot Ultra · Видео
подписанные ссылки на содержимое, принадлежащее Ailoot
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Проверить статус задачи
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Чтение другого содержимого
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Сохраняйте все готовые результаты
Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.
Сохраняйте каждый фактический результат, принадлежащий Ailoot, и возвращённые измеренные метаданные.
Если нужно проверить исходный ответ
503 result_pending_check + исходный id + X-Should-Retry:false; никогда не отправляйте исходный запрос повторно
Поля ответа
| Поле | Тип | Значение |
|---|---|---|
Полеindex | Типinteger | ЗначениеПозиция этого видео в списке результатов, начиная с нуля. |
Полеcontent_url | Типstring | ЗначениеПодписанный HTTPS URL для скачивания этого готового видео. |
Полеsha256 | Типstring | null | ЗначениеХэш SHA-256 исходных байтов видео; null, если недоступен. |
Полеsize_bytes | Типinteger | null | ЗначениеРазмер исходного видеофайла в байтах; null, если недоступен. |
Полеduration_ms | Типinteger | null | ЗначениеИзмеренная длительность видео в миллисекундах; null, если недоступна. |
Полеwidth | Типinteger | null | ЗначениеШирина видео в пикселях; null, если недоступна. |
Полеheight | Типinteger | null | ЗначениеВысота видео в пикселях; null, если недоступна. |
Полеvideo_codec | Типstring | null | ЗначениеИдентификатор видеокодека; null, если не записан. |
Полеhas_audio | Типboolean | null | ЗначениеЕсть ли у видео аудиодорожка; null, если не измерено. |
Полеaudio_codec | Типstring | null | ЗначениеИдентификатор аудиокодека; null, если идентификатор не записан. |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ404 · not_found_error | УсловиеДоступ к видео недоступен либо этот ID видео не найден. | Следующий шагПроверьте доступ к видео. Для существующего видео используйте исходный публичный ID и тот же ключ API. |
Ответ401 · authentication_error | УсловиеКлюч API не соответствует авторизованному аккаунту. | Следующий шагПеред отправкой проверьте ключ API и доступ к аккаунту. |
Ответ400 · invalid_request_error | УсловиеНе удалось прочитать запрос либо индекс скачивания недопустим. | Следующий шагИсправьте тело запроса. Для скачивания выберите индекс результата, возвращённый исходной задачей. |
Ответ422 · price_unavailable | УсловиеНевозможно определить цену выбранной конфигурации видео. | Следующий шагВыберите поддерживаемую конфигурацию видео и заполните обязательные параметры перед отправкой исправленного запроса. |
Ответ422 · invalid_request_error | УсловиеНедопустимы входное видео или исходная задача продолжения. | Следующий шагИспользуйте корректные входные HTTPS-ссылки. Для продолжения используйте исходный публичный ID вашего готового видео и тот же ключ API. |
Ответ402 · billing_error | УсловиеДоступный баланс или лимиты не позволяют зарезервировать средства. | Следующий шагПеред отправкой нового запроса проверьте доступный баланс и лимиты. |
Ответ503 · server_error | УсловиеПроверка видео, хранилище или доступ к сервису временно недоступны. | Следующий шагДождитесь доступности сервиса. Если у вас уже есть ID видео, проверяйте ту исходную задачу вместо создания новой генерации. |
Ответ503 · result_pending_check | УсловиеНужно проверить результат исходного видео и начисление. | Следующий шагСохраните возвращённый ID видео и проверьте эту задачу. Не отправляйте заменяющий запрос на генерацию, пока идёт проверка. |
Ответ503 · owned_result_unavailable | УсловиеСкачивание существующего видео временно недоступно. | Следующий шагПроверьте ту же видеозадачу позже и скачайте её существующий результат. Новая генерация создаёт отдельную операцию. |
Ответ409 · video_not_ready | УсловиеСодержимое видео не опубликовано. | Следующий шагПроверьте исходный статус задачи. Скачайте результат после completed; при failed следуйте уведомлению о проверке начисления. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra alibaba/wan-2.6
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Alibaba: Wan 2.6
- Какие входные данные и результаты доступны?
POST /v1/videos·alibaba/wan-2.6:text,image→video- Какие поля использует запрос?
POST /v1/videos·alibaba/wan-2.6:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Какие ограничения действуют?
POST /v1/videos·alibaba/wan-2.6:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807