APIMart
Назад к моделям
Иконка модели Seedream5.5
Изображение

Seedream5.5 API

Ознакомьтесь со сценариями Seedream5.5 API для создания изображений, точечных правок, многоязычного текста и композиций из нескольких изображений. Подготовьте запросы и референсы в рабочей области APIMart, затем изучите примеры API и таблицу параметров ниже.

Создание и редактирование изображенийМногоязычный текстТочные локальные изменения
Получить API ключДокументация API

Рабочая область Seedream5.5 API

  • 1K, 1.5K, 2K, соотношения сторон и свои размеры в пикселях
  • До 10 референсов; один для прозрачности или слоёв
  • JPEG / PNG, оптимизация запроса и настройки вывода
Input

Опишите объект, композицию, освещение и текст, который нужно добавить.

Референсные изображения

До 10 референсов или один для прозрачности и разделения на слои. Локальные файлы: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC или HEIF, до 30 МБ каждый. В JSON используйте общедоступные HTTP(S) URL или полные Data URI изображений; локальные файлы остаются предпросмотром в браузере.

У референсов каждая сторона должна быть больше 14 px, отношение ширины к высоте — 1/16–16, всего не более 36 000 000 пикселей. Прозрачный фон требует входное изображение с альфа-каналом.

Результат

Созданные изображения появятся здесь

Составьте понятное визуальное задание для Seedream5.5 API

Подготовьте черновик Seedream5.5 API для новой сцены или точечной правки. Опишите объект, свет и композицию, затем отделите нужные изменения от деталей, которые следует сохранить.

Получить API-ключ

Примеры Seedream5.5 API: создание и редактирование изображений

Примеры Seedream5.5 API используют общий асинхронный формат задач APIMart с запросами, референсами, размером, разрешением и параметрами вывода. Используйте возвращённый ID задачи для отдельного запроса результата.

  1. 1

    Настройте API-ключ

    Сохраните API-ключ APIMart в переменной APIMART_API_KEY. Примеры Seedream5.5 API используют Authorization: Bearer <key> как для отправки задачи, так и для проверки её состояния.

  2. 2

    Составьте запрос Seedream5.5 API

    Пример использует POST /v1/images/generations с model: seedream-5.5, полями prompt, size, resolution и output_format. Для редактирования добавьте image_urls. Прочитайте ID задачи из data[0].task_id.

  3. 3

    Получите результат задачи API

    Используйте GET /v1/tasks/{task_id}. Для завершённой задачи прочитайте data.result.images[0].url[0]; для неудачной задачи — data.error.message.

    Сведения об авторизации и общих принципах работы API доступны в документации APIMart.

POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "prompt": "Рекламный плакат в редакционном стиле: белая керамическая чашка на светлом деревянном столе, мягкий боковой свет, заголовок «УТРЕННИЙ РИТУАЛ» вверху, чёткая типографика и много свободного пространства.",
    "size": "16:9",
    "resolution": "1.5K",
    "output_format": "png"
  }'

Параметры Seedream5.5 API

ПараметрТипОбязательныйПо умолчаниюОписание
modelstringДаПо умолчанию: seedream-5.5Значение model в рабочей области Seedream5.5 API и её примерах: seedream-5.5.
promptstringДаПо умолчанию: —Инструкция для Seedream5.5: опишите новое изображение или правки и детали, которые нужно сохранить. Необязательна, если layer_decomposition равен true.
sizestringНетПо умолчанию: 1:1В рабочей области по умолчанию задано 1:1. Можно выбрать auto; соотношение 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9; уровень 1K, 1.5K, 2K; либо свои размеры, например 2048x1024. Произвольные размеры должны давать 921 600–4 624 220 пикселей при отношении ширины к высоте 1/16–16.
resolutionstringНетПо умолчанию: 1KРазрешение черновика Seedream5.5 API: 1K, 1.5K или 2K. Применяется, когда size задан соотношением сторон или auto. Для размера по уровню, в пикселях и при разделении на слои поле опускается.
image_urlsarrayНетПо умолчанию: —До 10 референсов в виде общедоступных HTTP(S) URL или полных base64 Data URI изображений. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF, до 30 МБ каждый. Отношение ширины к высоте — 1/16–16, каждая сторона больше 14 px, всего не более 36 000 000 пикселей. Для прозрачности или разделения на слои нужен ровно один референс. Локальные blob URL служат для предпросмотра в браузере.
output_formatstringНетПо умолчанию: jpegФормат вывода: jpeg или png. При выборе прозрачного фона в форме автоматически выбирается PNG.
backgroundstringНетПо умолчанию: opaqueopaque или transparent. Прозрачный фон требует ровно одно входное изображение с альфа-каналом и вывод в PNG.
layer_decompositionbooleanНетПо умолчанию: falseРазделяет один референс PNG или JPEG на базовое изображение и прозрачные слои. В этом режиме size принимает только auto, 1K, 1.5K или 2K; prompt необязателен, а resolution опускается.
optimize_prompt_optionsobjectНетПо умолчанию: OmittedНеобязательная оптимизация запроса: {"mode":"standard"}. По умолчанию в рабочей области она выключена, поэтому поле опускается.
watermarkbooleanНетПо умолчанию: falseДобавлять ли на выходное изображение водяной знак о создании с помощью ИИ.
nsfw_checkbooleanНетПо умолчанию: falseПроверять ли запрос и входные изображения перед обработкой задачи API.
nintegerНетПо умолчанию: 1Обычная генерация выдаёт одно изображение. JSON принимает только n: 1; рабочая область опускает это поле в нормализованной конфигурации.