LogoДокументация Wan API
Главная
X (Twitter)
Главная

Начало работы

ОбзорРуководство по интеграцииПроверка балансаУдаление задачи

Модели Wan

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Модели Seedance

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Модели изображений

Seedream 5.0 ProAPI Seedream 5.5

Языковые модели

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

API Seedream 5.5

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

Seedream 5.5 создаёт одно изображение по тексту или с использованием до 10 референсных изображений. Разделение на слои принимает одно изображение и возвращает основу и прозрачные слои с необязательным результатом распознавания печатного текста.

Попробовать Playground · OpenAPI JSON · Руководство по интеграции

Аутентификация и конечные точки

Используйте ключ Wan API как токен Bearer. Один ключ открывает доступ ко всем доступным моделям и группам; выбирать группу для ключа не требуется.

МетодURLНазначение
POSThttps://api.wanapi.app/seedream55/v1/images/generationsОтправить одну задачу изображения
GEThttps://api.wanapi.app/seedream55/v1/tasks/{id}Прочитать эту задачу

ID модели — seedream-5-5. Это асинхронные конечные точки. Отправьте запрос один раз, сохраните ID задачи и опрашивайте её до completed или failed. Неопределённый сетевой ответ не даёт оснований повторять отправку.

Создание изображения

curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'

Принятый запрос возвращает задачу, а не байты изображения:

{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"

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

Параметры

ПараметрТипПо умолчаниюПравила
modelстрокаобязателенseedream-5-5
promptстрокаобязателен для генерацииНеобязателен для разделения на слои.
imageURL или массив URLнетДо 10 референсов; ровно один для слоёв. Каждый референс оплачивается.
sizeстрока2K или auto для слоёвСм. правила размеров ниже.
output_formatстрокаpngpng или jpeg. Для слоёв определяет только основное изображение.
backgroundстрокаautoauto, opaque, transparent. Для прозрачности требуется PNG. Полностью исключите поле в режиме слоёв.
layer_decompositionлогическийfalseРазделить один референс на основное изображение и прозрачные слои PNG.
layer_decomposition_options.max_imagesцелое число30Общий лимит 2–100 изображений, включая основное. Только для режима слоёв.
layer_decomposition_options.text_recognitionлогическийfalseЗапросить метаданные печатного текста в слоях. Только для режима слоёв.
optimize_prompt_options.modeстрокаstandardПоддерживается только режим standard.
watermarkлогическийfalseЗапросить водяной знак о генерации ИИ.
content_filterлогическийtrueКлиентский API принимает false. В Playground отключать проверку могут только администраторы.

Параметры n, seed, stream, resolution, aspect_ratio, image_urls и response_format не поддерживаются. Недокументированные поля отбрасываются и не включают эти возможности. Загрузка multipart, Base64 и data URI отклоняются.

Размер результата

Генерация принимает 1K, 1.5K, 2K или точные размеры WIDTHxHEIGHT в пикселях. Общая площадь должна составлять 921 600–4 624 220 пикселей, а соотношение сторон — от 1:16 до 16:1. Например, 2048x1152 допустимо. Соотношение вроде 16:9 не является значением размера.

Разделение на слои принимает auto, 1K, 1.5K или 2K; точные размеры в пикселях в этом режиме не поддерживаются. auto следует исходному размеру и резервирует стоимость по большему тарифу результата. Готовых размеров 3K и 4K у модели нет.

Референсные изображения и редактирование

Передавайте общедоступные HTTP(S) URL размещённых вами файлов без встроенных учётных данных. Поддерживаются JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF, до 30 МБ на изображение и не более 36 000 000 пикселей всего. AVIF и JP2 не поддерживаются. URL должен отдавать изображение напрямую, без входа в аккаунт или браузерной проверки.

{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}

Для нескольких референсов передайте массив URL и объясните роль каждого изображения в промпте. Результатом по-прежнему будет одно изображение. URL референсов в примерах — заполнители: замените их своими доступными файлами.

Разделение на слои и распознавание текста

{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}

Лимит включает основное изображение; 4 означает не более четырёх полученных изображений, а не четыре слоя плюс основа. Модель может вернуть меньше. Не передавайте prompt для автоматического разделения или назовите элементы для отделения. Промпт может подавить исключённый им текст.

Слои — это файлы PNG с прозрачностью. Восстанавливайте изображение по возрастанию z_index, с основой на 0. Если задан ограничивающий прямоугольник, перед размещением измените размер слоя под него: пиксельные размеры файла слоя могут отличаться от размеров его размещения.

Необязательное поле text_recognition содержит полный text и lines. Каждая строка может включать bounding_box и оформленные фрагменты runs. Поле style фрагмента может включать similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow и translucent. Это оценки модели. Для художественных или рукописных надписей текстовый результат может отсутствовать; считайте поле необязательным.

Ответ завершённой задачи

{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}

У каждого изображения есть url и size. Другие поля могут включать output_format, background, z_index, name, description, bounding_box и text_recognition. bounding_box.absolute — это [left, top, right, bottom] в пикселях основного изображения. bounding_box.normalized использует те же координаты в масштабе 0–1000. Не считайте, что необязательные метаданные есть у каждого изображения.

Считайте URL изображений приватными ссылками для скачивания и сохраняйте нужные файлы. URL с токеном access можно открыть, не раскрывая ключ API аккаунта.

Цены

Оплачиваемое изображениеUSD за изображение
Результат до 2,61 Мп (1K / 1.5K)0,017 $
Результат свыше 2,61 Мп (2K)0,02975 $
Каждое референсное изображение, включая первое0,0068 $

Тарифы обновляются автоматически. Один ключ API работает со всеми моделями и группами.

Граница тарификации результата — 2 610 000 пикселей. Рассчитывайте стоимость так:

lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate

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

Ошибки и повторные попытки

Некорректные параметры отклоняются до отправки. Недостаточный баланс или квота ключа препятствуют генерации. Аутентификация и проверка владельца применяются и к отправке, и к опросу. Неудачная задача возвращает status: "failed" с объектом error.

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

В руководстве по Seedream 5.5 приведён цикл приложения, который сохраняет ID задачи и возобновляет работу с ним.

Seedream 5.0 Pro

Seedream 5.0 Pro API: генерация, редактирование, слои, прозрачный PNG, поля запросов, ответы и цены.

Claude API

Claude через Anthropic Messages и OpenAI Chat Completions: ID моделей, потоковые ответы и актуальные цены на вход, выход и кеш по группам.

Содержание

Аутентификация и конечные точкиСоздание изображенияПараметрыРазмер результатаРеференсные изображения и редактированиеРазделение на слои и распознавание текстаОтвет завершённой задачиЦеныОшибки и повторные попытки