APIMart
Иконка модели Seedream 5.5
Изображение

Seedream 5.5 API

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

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

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

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

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

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

Результат
Model preview

Цены на Seedream 5.5 API

Прозрачные цены без скрытых комиссий. Платите только за то, что используете.

* Фактические расходы зависят от конечного результата.

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

Подготовьте черновик Seedream5.5 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

    Отправьте model: seedream-5-5 через POST /v1/images/generations. Для редактирования добавьте image_urls и получите task_id из ответа. Пример Python также поддерживает ответы с обёрткой data.

  3. 3

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

    Проверяйте GET /v1/tasks/{task_id}. При SUCCESS читайте result.images, при FAILURE — fail_reason. Пример также поддерживает completed/failed.

    Сведения об авторизации и общих принципах работы 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НетПо умолчанию: 2KПо умолчанию 2K. 1K/1.5K/2K, пропорция с resolution или пиксели (921 600–4 624 220, пропорции 1/16–16). Слои: только auto/1K/1.5K/2K. Выбранный размер применяется к основе и каждому слою с сохранением их пропорций. Auto использует размер входного изображения в пределах 1K–2K; резервирование идёт по высокому тарифу. По умолчанию 2K. Выберите 1K или 1.5K для меньшей стоимости. Референсы оплачиваются отдельно. При генерации изображений auto соответствует 2K.
resolutionstringНетПо умолчанию: 2K / autoПри генерации с соотношением сторон: 1K / 1.5K / 2K, по умолчанию 2K. Для слоёв size имеет приоритет; resolution используется только без size. Допустимы 1K / 1.5K / 2K / auto, по умолчанию auto.
image_urlsarrayНетПо умолчанию: —До 10 референсов, включая прозрачную генерацию. HTTP(S)-ссылки, Data URI изображений или локальные JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. На изображение: до 30 MiB и 36 мегапикселей. Локальные файлы загружаются при запуске. Для разделения на слои требуется ровно один референс. Тариф выходного размера + число референсов × цена входного изображения. Каждый референс оплачивается.
output_formatstringНетПо умолчанию: pngФормат вывода: jpeg или png. При выборе прозрачного фона в форме автоматически выбирается PNG. При разделении на слои настройка влияет только на формат основы. Остальные слои всегда сохраняются в PNG.
backgroundstringНетПо умолчанию: autoauto (по умолчанию), transparent или opaque. Прозрачный фон возможен с референсом и без него, нужен PNG. В режиме слоёв background не передаётся.
layer_decompositionbooleanНетПо умолчанию: falseРовно один референс. Prompt необязателен; size: auto/1K/1.5K/2K. Не передавайте background. Резервирование: max_images × тариф размера плюс один референс. Диапазон 2–100, по умолчанию 30. Итог зависит от фактического числа результатов и их пиксельных тарифов. Уменьшите лимит для снижения резерва.
optimize_prompt_optionsobjectНетПо умолчанию: standard{"mode":"standard"}. Оптимизация промпта всегда работает в режиме standard; отключить её нельзя. При отсутствии параметра также применяется standard.
watermarkbooleanНетПо умолчанию: falseДобавлять ли на выходное изображение водяной знак о создании с помощью ИИ.
nsfw_checkbooleanНетПо умолчанию: falseПроверять ли запрос и входные изображения перед обработкой задачи API.
nintegerНетПо умолчанию: 1Обычная генерация выдаёт одно изображение. JSON принимает только n: 1; рабочая область опускает это поле в нормализованной конфигурации.
layer_decomposition_options.max_imagesintegerНетПо умолчанию: 30Резервирование: max_images × тариф размера плюс один референс. Диапазон 2–100, по умолчанию 30. Итог зависит от фактического числа результатов и их пиксельных тарифов. Уменьшите лимит для снижения резерва. Более 30 изображений требуют больше времени; 100 изображений могут занять около 5 минут.
layer_decomposition_options.text_recognitionbooleanНетПо умолчанию: falseВозвращает распознанный текст и предполагаемые стили текстовых слоёв. Для рукописного, декоративного текста и нетекстовых слоёв OCR может отсутствовать. Для OCR рекомендуется оставить промпт пустым: при его заполнении результаты распознавания могут не возвращаться.