Seedream 5.0 Pro

Seedream 5.0 Pro создаёт одно изображение по промпту, редактирует или объединяет до 10 референсных изображений и разделяет одно изображение на основу и до 16 прозрачных слоёв. Результат: 1K, 1.5K, 2K или точный размер в пикселях. Описание модели и Playground.

Подключение к Wan APIКопировать ссылку на заголовок

Используйте https://api.wanapi.app как базовый URL API. Создайте ключ в настройках API-ключей; один ключ работает со всеми моделями. Передавайте его как Authorization: Bearer YOUR_API_KEY. Храните ключи на сервере. Playground использует ваш сеанс на сайте и списывает средства с того же баланса.

GET /v1/models возвращает модели, доступные вашему ключу. Seedream 5.0 Pro использует два эндпоинта: POST /seedream/v1/images/generations однократно отправляет запрос и возвращает задачу, а GET /seedream/v1/images/generations/{task_id} возвращает её статус и, после завершения, изображения.

Отправка задачи Seedream 5.0 ProКопировать ссылку на заголовок

На сервере задайте ваш ключ в WAN_API_KEY. Отправьте запрос один раз и сохраните возвращённый id.

curl https://api.wanapi.app/seedream/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
  "size": "1K"
}'

Ответ с задачей приходит сразу. ID и временные метки в примере приведены для иллюстрации:

{
  "id": "task_EXAMPLE",
  "object": "image.generation.task",
  "model": "bytedance/seedream-5.0-pro",
  "status": "processing",
  "created_at": 1792022400
}

Проверка задачи Seedream 5.0 ProКопировать ссылку на заголовок

Сохраните возвращённый id как TASK_ID и запрашивайте статус тем же ключом каждые пять секунд. Большинство изображений готово в течение минуты; разделение на слои в 2K может занять около двух минут.

curl "https://api.wanapi.app/seedream/v1/images/generations/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Завершённая задача перечисляет изображения в data. Временные метки указаны в секундах Unix:

{
  "id": "task_EXAMPLE",
  "object": "image.generation.task",
  "model": "bytedance/seedream-5.0-pro",
  "status": "completed",
  "created_at": 1792022400,
  "completed_at": 1792022430,
  "data": [
    {
      "url": "https://cdn.example.com/image-1.jpg",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}

URL изображений — подписанные ссылки, доступные 30 дней; используйте их напрямую без API-ключа и сохраняйте файлы у себя, если они нужны дольше. Проверка задачи никогда не запускает новую генерацию.

Цены Seedream 5.0 ProКопировать ссылку на заголовок

Каждое созданное изображение оплачивается отдельно по его размеру в пикселях, на 30% ниже официального тарифа: до 2,61 миллиона пикселей (1K и 1.5K) применяется меньший тариф, для более крупных изображений — больший. Первое референсное изображение бесплатно; каждое дополнительное оплачивается по тарифу референса. Запрос, отклонённый до создания изображения, не оплачивается.

При разделении на слои оплачивается основа и каждый возвращённый слой. Если каждое возвращённое изображение содержит до 2,61 миллиона пикселей, оно стоит на 30% меньше официального тарифа для слоёв. Если хотя бы одно изображение крупнее, что всегда происходит при 2K, каждое изображение оплачивается по официальному тарифу для слоёв своего размера. Баланса должно хватать максимум на 17 изображений; оплачиваются только возвращённые изображения.

Поля запросаКопировать ссылку на заголовок

Отправьте JSON-объект. model обязателен; prompt обязателен, если layer_decomposition не равен true. Неизвестные поля отклоняются.

Результаты всегда возвращаются как URL изображений, поэтому значения response_format, отличные от url, отклоняются. Эта модель не поддерживает stream, sequential_image_generation, tools, seed, guidance_scale и mask; эти поля отклоняются.

Редактирование и объединение референсовКопировать ссылку на заголовок

Передайте одно изображение с инструкцией редактирования или несколько изображений для объединения:

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
  "image": [
    "https://example.com/bottle.png",
    "https://example.com/table.jpg"
  ],
  "size": "2K",
  "output_format": "png"
}

Локальные файлы не принимаются: загрузите изображение в собственное хранилище и передайте его общедоступный HTTP(S) URL в image.

Разделение на слоиКопировать ссылку на заголовок

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Separate the title text, the parrot and the background",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K"
}

В завершённой задаче основа указана первой. Для каждого слоя добавляются порядок наложения, положение и описание:

{
  "id": "task_EXAMPLE",
  "object": "image.generation.task",
  "model": "bytedance/seedream-5.0-pro",
  "status": "completed",
  "created_at": 1792022400,
  "completed_at": 1792022510,
  "data": [
    { "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://cdn.example.com/image-2.png",
      "size": "1273x265",
      "output_format": "png",
      "z_index": 1,
      "bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
      "name": "Title text",
      "description": "Yellow serif title text"
    }
  ],
  "usage": { "input_images": 1, "generated_images": 2 }
}

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

ОшибкиКопировать ссылку на заголовок

Отклонённая отправка возвращает HTTP-ошибку с code и message; задача не создаётся:

Задача, завершившаяся ошибкой после принятия, возвращает "status": "failed" с объектом error и не оплачивается:

{
  "id": "task_EXAMPLE",
  "object": "image.generation.task",
  "model": "bytedance/seedream-5.0-pro",
  "status": "failed",
  "created_at": 1792022400,
  "error": {
    "code": "generation_failed",
    "message": "The request was rejected by the content policy"
  }
}

Если отправка завершилась тайм-аутом до получения id задачи, результат неизвестен. Не повторяйте POST автоматически: это может создать вторую платную задачу. Сначала проверьте журнал задач.