Seedream 5.5

Модель seedream-5-5 создаёт одно изображение по тексту или редактирует изображение с использованием до 10 референсов.

Запрос


curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $APIHUBS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "input": {
      "prompt": "An orange cat sticker with clean edges",
      "size": "2K",
      "background": "transparent",
      "outputFormat": "png"
    }
  }'

Параметры

Все параметры передаются в объекте input. Неизвестные поля отклоняются.

Параметр	Тип	Обязательный	По умолчанию	Описание
`prompt`	string	Да	—	Описание изображения или инструкции для редактирования.
`urls`	string[]	Нет	—	До 10 общедоступных HTTP(S) URL или base64 `data:image` URI с форматом в нижнем регистре.
`size`	string	Нет	`1:1`	Уровень `1K`, `1.5K`, `2K`, значение `auto`, соотношение сторон или точный размер `ШИРИНАxВЫСОТА`.
`resolution`	string	Нет	`1K` для соотношения сторон или `auto`	`1K`, `1.5K` или `2K`. Не указывайте вместе с точными размерами или уровнем разрешения в `size`.
`background`	string	Нет	`auto`	`auto`, `transparent` или `opaque`. Для прозрачности нужен PNG.
`outputFormat`	string	Нет	`png`	`png` или `jpeg`.
`promptOptimizeMode`	string	Нет	`standard`	Допустим только `standard`. Оптимизацию нельзя отключить.

Референсы: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF. Каждый файл должен быть не более 30 МиБ и 36 миллионов пикселей. AVIF и JP2 не поддерживаются; ограничения удалённых файлов также проверяет провайдер.

Соотношения сторон: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2. Вместо двоеточия допустим x, например 16x9.

Для точного размера нужны положительные целые ширина и высота, площадь от 921 600 до 4 624 220 пикселей и отношение ширины к высоте от 1/16 до 16. Например, 2048x1152. Поле resolution при этом не передаётся. auto позволяет модели выбрать пропорции по описанию; разрешение задаётся отдельно, по умолчанию 1K.

Редактирование


{
  "model": "seedream-5-5",
  "input": {
    "prompt": "Place the product from the first image in the setting of the second",
    "urls": ["https://example.com/product.png", "https://example.com/setting.jpg"],
    "size": "16:9",
    "resolution": "1.5K"
  }
}

Стоимость и ограничения

Актуальные ставки доступны на странице цен. Каждый входной референс оплачивается отдельно, включая первый; к цене результата добавляется ставка reference_image для 1K/1.5K или reference_image_2K для 2K за каждый вход.

Для 1K и 1.5K используется нижняя ставка. Для 2K — верхняя; запрос без размера использует 1K и нижнюю ставку. Для auto ставка определяется выбранным resolution (по умолчанию 1K). При точных размерах нижняя ставка применяется до 2 610 000 пикселей включительно, выше — верхняя.

По умолчанию создаётся квадратное изображение 1:1 в 1K. Запрос создаёт одно изображение. Поле количества n, декомпозиция на слои и OCR через этот эндпоинт не доступны. Прозрачный фон несовместим с JPEG; неподдерживаемые параметры возвращают HTTP 400 до списания.

Результат

Ответ на создание содержит data.taskId. Получить результат можно опросом:


curl https://api.apihubs.ru/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $APIHUBS_KEY"

Готовая задача имеет статус finished, ссылки находятся в data.files[].fileUrl. Вместо опроса можно передать webhook на верхнем уровне запроса. Результат сохраняется в хранилище платформы, при неуспешной генерации списание возвращается.

См. Задачи и вебхуки.