Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 |
bounding_boxes | Нет | Rectangles marking the areas to edit, in pixels from the top-left corner of the reference image each one belongs to. Up to 2 per image. |
color_palette | Нет | Custom colour theme: 3 to 10 colours, each with an optional share of the image in percent. Leave the shares empty to split them evenly. |
image_urls | Да | Фото для правки или объединения. В промпте укажите, что берётся из каждого. |
num_outputs | Нет | Сколько результатов сделать за раз. ≥ 1 · ≤ 4 · По умолчанию: 1 |
prompt | Да | Describe the image to produce from the source: subject, composition, style, and lighting. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 1k · 2k · По умолчанию: 1k |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 4,5 | 0,045 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 5 кредитов за изображение (0,05 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Wan 2.7 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model alibaba/wan-2.7/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-2.7/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"num_outputs": 1,
"resolution": "1k"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Wan 2.7
Сколько стоит API Wan 2.7?
Wan 2.7 стоит от 5 кредитов (0,05 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Wan 2.7 в API?
Укажите alibaba/wan-2.7/text-to-image — Создать картинку; alibaba/wan-2.7/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Сколько референсов принимает Wan 2.7?
Image-to-image принимает от одной до девяти картинок за вызов, сводя их под одним prompt. Text-to-image не принимает ни одной: это отдельный контракт без поля image_urls.
Какого размера картинка Wan 2.7?
Около 1,01–1,05 мегапикселя на разрешении 1k по умолчанию, и этот бюджет поровну делится между всеми семью соотношениями, так что кадр 16:9 шире, но не больше. С resolution = 2k — примерно вчетверо больше. Wan 2.7 Pro начинается с 2k и добавляет на text-to-image ступень 4k. В image-to-image без заданного соотношения картинка берёт пропорции последнего референса на выбранной ступени.
Какие соотношения сторон поддерживаются?
1:1, 4:3, 3:4, 16:9, 9:16, 3:2 и 2:3. У text-to-image по умолчанию 1:1; у image-to-image значения по умолчанию нет, и без него он идёт за референсом.
Можно ли получить ту же картинку дважды?
Фиксированный seed помогает ограничить случайные различия, но не гарантирует одинаковый результат.
Чем Wan 2.7 отличается от Wan 2.7 Pro?
В основном холстом. На text-to-image Pro по умолчанию работает в 2k, это около 4 мегапикселей, и добавляет ступень 4k примерно на 16 мегапикселей, которой в этом семействе нет. На image-to-image Pro работает в 2k, около 4 мегапикселей, и настроен под правки с несколькими одновременными ограничениями; это семейство правит в 1k, если вы не попросите 2k.
Какие ограничения у API Wan 2.7?
Разрешения: 1K · 2K; Соотношения сторон: 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3; Результатов за вызов: 1–4; Референсные изображения: 9; Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Wan 2.7 без кода?
Да. Playground запускает Wan 2.7 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Wan
Wan 2.7 Pro добавляет холст 4K для текста в изображение и правки в 2K, которые держат более длинные инструкции.
- Wan 3.0 APIКлипы до 30 секунд с синхронным звукомОт 34 кредитов за клип длиной 5 с
- Wan 3.0 Prime APIУскоренный Wan 3.0, до 30 секунд со звукомОт 46 кредитов за клип длиной 5 с
- Wan 3.0 Pro Prime APIУскоренный Wan 3.0 Pro с выводом в 2K и 4KОт 176 кредитов за клип длиной 5 с
- Wan 3.0 Pro APIWan 3.0 в 1080p, 2K или 4K, до 30 секундОт 108 кредитов за клип длиной 5 с
- Wan 2.7 Pro APIБольшие полотна в 4K и коллажи из девяти картинокОт 12 кредитов за изображение
- Wan 2.7 APIСначала продумывает композицию, потом рисует до четырёх картинокОт 5 кредитов за изображение
- Wan 2.6 Flash APIБыстрые мультикадровые клипы из одной картинкиОт 17 кредитов за клип длиной 5 с
- Wan 2.6 APIМультикадровые сцены со звуком, до 1080pОт 49 кредитов за клип длиной 5 с
- Wan 2.5 APIКлипы 1080p со звуком, которые могут идти под твоё аудиоОт 34 кредитов за клип длиной 5 с
- Wan 2.2 Animate APIОживляет фото персонажа по видео-референсуОт 7,95 кредита за секунду
- Wan 2.2 LoRA APIВидео Wan 2.2 с твоими LoRA на любом из двух экспертных проходовОт 18 кредитов за клип длиной 5 с
- Wan 2.2 APIПростые пятисекундные клипы в 480p или 720pОт 36 кредитов за генерацию
- Wan 2.2 5B LoRA APIЛёгкие клипы Wan 2.2 в 720p, загружает твои LoRAОт 18 кредитов за генерацию
- Wan 2.2 Image LoRA APIКадры Wan 2.2: до девяти LoRA в трёх слотахОт 5 кредитов за изображение
- Wan 2.1 LoRA APIВидео и правки Wan 2.1 с твоими LoRA, включая движения камерыОт 36 кредитов за генерацию
- Wan 2.1 Image LoRA APIФотореалистичные кадры и смена стиля на Wan 2.1 с твоими LoRAОт 5 кредитов за изображение

