Wan API в России

Как купить доступ к Wan API в России

Продавец здесь мы: войдите, пополните баланс и выпустите ключ. Ни учётной записи в Alibaba Cloud, ни доступа в его Model Studio для этого не нужно.

Пополнение идёт рублями с карты российского банка. Ставка одна на все режимы: 9 ₽ за секунду в 720p и 13,5 ₽ в 1080p.

Кредиты покупают пакетом от 500 ₽, в котором 1 000 кредитов. Под каждую задачу кредиты сначала резервируются, а списывается фактический расход.

Все четыре режима лежат на одном счёте, а переключение между ними — это другое имя в поле model. Ежемесячной платы за доступ не предусмотрено: со счёта уходит стоимость выполненных задач. Кредиты видны на балансе сразу после оплаты, и подтверждать покупку отдельно не приходится.

Что входит в Wan: линейка из четырёх режимов и новое поколение

Alibaba выпустила Wan 2.7 набором из четырёх моделей: генерация из текста, из картинки, работа по образцам и правка готового ролика. Ровно эти четыре записи и стоят у нас на витрине. Подаёт разработчик их вместе — как переход от отдельных кусков к работе над цельным фильмом.

Рядом с линейкой 2.7 на витрине стоит следующее поколение — Wan 3.0 Video. Оно вынесено отдельной записью, потому что и ставка у него своя, и на вход оно берёт больше: кроме описания и кадров — образцы роликов и звука, документ и веб-страницу. Ставка и пределы этой записи стоят на её странице.

Длительность зависит от режима: генерация из текста и из картинки — до 15 секунд, работа по образцам и правка готового ролика — до 10. Разрешение везде одно из двух — 720p или 1080p. Что кладётся в тело запроса, разобрано в разделе «Wan».

Про само семейство и его выпуски написано на странице Wan нейросеть, а про запуск ранних выпусков на своей видеокарте — на странице Wan в ComfyUI.

Разбор режимов Wan: что кладут в запрос и что выходит

У каждого режима своё имя в поле model, а полей у них больше общих, чем собственных. Обязательное поле при этом разное: съёмке нужно описание, правке — ссылка на исходный ролик. Описание вмещает до 5 000 знаков, и рядом стоит отрицательное — до 500.

Файлы приходят ссылками, и набор полей под них у режимов свой. У съёмки от присланного кадра их четыре: первый кадр, последний кадр, ролик для продолжения и звук. Работа по образцам берёт два списка — до 5 картинок и столько же готовых роликов.

Разрешение выбирается полем resolution, и значений у него два — 720p и 1080p. Поле duration у правки принимает ноль, и это не пустой результат, а полная длина исходника. Родную звуковую дорожку правка умеет оставить нетронутой — за это отвечает поле audio_setting.

Повторяемость даёт поле seed: с тем же значением и тем же описанием выходит прежний результат. Собранное тело запроса со всеми полями показывает песочница на странице модели.

Все ссылки — на кадр, на исходный ролик и на звук — принимаются полным адресом на http или https. Адрес должен открываться снаружи: имени и пароля перед ним, как и постороннего порта, шлюз не примет. Свой файл с диска сначала загружают и получают адрес, а как это делается, показано в разделе «Загрузка своих файлов».

Что нужно, чтобы получить ключ к Wan API

Вход на сайт — единственное условие. Ключ выпускается в кабинете и работает по всем четырём режимам. Имя ключу задают своё, до 60 знаков; отзывается он там же, где создан.

Тем же ключом открывается остальной каталог — картинки, языковые модели и видео других поставщиков. Как ключ подставляется в запрос, показано в разделе «Ключ и заголовки».

Расход по каждому ключу считается отдельно, и в кабинете он виден строкой на каждый запуск. Отозванный ключ перестаёт работать сразу, а на соседние ключи счёта это никак не влияет.

Как вызывается Wan API: задача ставится первой командой, файл забирается второй

Все четыре режима вызываются одинаково, и разница между ними живёт только в теле запроса. Первая команда заводит задачу: POST на https://api.gen202.com/api/v1/jobs/createTask с именем режима в поле model. В ответ приходит номер задачи, и больше в нём ничего нет — работа только началась.

1. Заведение задачи. POST на https://api.gen202.com/api/v1/jobs/createTask, и тело у него устроено одинаково во всех четырёх режимах.
2. Ответ на постановку. Возвращается номер задачи, и другого содержимого в этом ответе нет — работа только началась.
3. Опрос по номеру. GET на /api/v1/jobs/recordInfo с тем же номером, а паузу между опросами держат в 3 секунды.
4. Поле state. Пока работа идёт, в поле state стоит waiting, queuing или generating.
5. Готовый файл. Ссылка на него приходит внутри resultJson — поля, которое передаётся строкой с JSON внутри.

Закончившаяся задача приходит со словом success или fail, и опрашивать её дальше незачем. Достают ссылку вторым разбором, и это единственная особенность ответа, о которой надо знать заранее. Живёт эта ссылка 14 дней: столько файл лежит у поставщика.

Ключ ставится заголовком Authorization в обе команды, и другого способа назвать себя у них нет. Крайний срок у видеозадачи — 60 минут; неотвеченную задачу шлюз закрывает сам и деньги отпускает.

Пределы частоты привязаны к ключу: 30 постановок в минуту и 300 опросов. Незакрытых задач на счёте бывает не больше 50 одновременно. Подробности эксплуатации собраны в разделе «Лимиты и эксплуатация».

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

Из чего складывается счёт за Wan и что бывает при неудаче

Ставка у всех режимов одна, поэтому сумма зависит только от разрешения и числа секунд. В 720p секунда обходится в 9 ₽, в 1080p — в 13,5 ₽. Переход с одного режима на другой цену не меняет: её меняет выбранное разрешение.

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

Потолок отложенного у режимов разный, потому что разный потолок оплачиваемых секунд. Генерация из текста упирается в 202,5 ₽, а правка готового ролика — в 270 ₽. У правки секунды считаются по сумме входа и выхода — так тарифицирует эту работу поставщик.

Не хватает свободных кредитов под отложенное — задача не заводится, приходит 402. Отказ по форме запроса выносится раньше расчёта, и кредиты в нём не участвуют вовсе. Как посмотреть расход по ключу, показано в разделе «Баланс и расход».

Какие отказы возвращает Wan API и что они означают

Отказов здесь два рода, и приходят они по-разному. Одни отвечают на команду, другие описывают неудачу уже созданной задачи. Вторые приходят полем failCode внутри успешного ответа о состоянии.

Ответ 401 приходит, когда ключа в заголовке нет или он больше не действует. Ответ 422 говорит про поле: неизвестный режим, значение вне списка, непринятая ссылка. Ответ 429 — превышена частота либо набралось слишком много незакрытых задач.

Ссылку на исходный ролик шлюз разбирает у себя: он смотрит схему, длину и то, куда адрес ведёт. Адрес внутри сети или без общедоступного имени отбивается сразу, и обращения к Alibaba не будет. Тело тяжелее 512 КиБ получает 413, а чужой тип содержимого — 415.

Задача, которая не удалась, приходит со словом fail и кодом причины. Код 501 — поставщик отказался делать ролик, 408 — работа не уложилась в крайний срок. Код 404 ставится, когда задачи у поставщика не нашлось, 500 — когда сломалось на нашей стороне.

Во всех этих случаях удержание снимается целиком, а объяснение приходит в поле failMsg. Опрос по чужому номеру отвечает 404: задачи другого счёта наружу не отдаются. Разбор каждого ответа шлюза стоит в разделе «Отказы».

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

Нужен ли ключ Alibaba, чтобы вызвать Wan

Нет. Для вызова Wan ключ Alibaba Cloud вам не понадобится: к поставщику ходит наш шлюз и своим ключом.

Можно ли купить у нас API ключ Alibaba

Ключи Alibaba выдаёт она сама, в своём Model Studio. Мы продаём вызовы Wan по своему ключу и своему адресу.

Свой ключ живёт, пока вы сами его не отзовёте, а кредиты лежат на счёте.

Есть ли бесплатный доступ к Wan API

Счёт за видео идёт по факту, а первые секунды покрывают приветственные кредиты. Первый вход приносит 50 кредитов; по нижней ставке это 2 секунды ролика.

Форму запроса и сумму удержания видно до оплаты — их показывает песочница. Задача, которая не удалась, денег не стоит: удержание возвращается.

Что Wan делает с готовым видео

Правку Alibaba описывает обычными словами, и перечень того, что она трогает в готовом ролике, разработчик называет сам.

• Действие персонажа — то, что герой делает в кадре, — заменяется на названное в описании.
• Реплика героя пересобирается вместе с движением губ, а голос при этом остаётся прежним.
• Внешность героя меняется, и той же правкой меняется обстановка вокруг него.
• Стиль картинки и способ съёмки задаются словами наравне со всем остальным.

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

Работать из России можно без VPN, а платить — рублями с карты российского банка. Прямой доступ идёт через биллинг поставщика, и счёт он выставляет в долларах. GEN202 стоит между вами и поставщиком: расчёты с ним наши, вы платите российскому продавцу.

Wan — видеомодели Alibaba. Кроме генерации ролика они умеют переделывать готовое видео по текстовому указанию.