Руководство по API Seedream 5.5: цены, параметры и примеры вызова

Что умеет Seedream 5.5

Seedream 5.5 — это модель изображений на HiAPI: один ID модели (seedream-5.5) одновременно покрывает два сценария использования: если указать только промпт, это генерация изображения по тексту; если дополнительно приложить референсные изображения, это редактирование по референсу или сохранение содержимого изображения. Оба сценария используют один и тот же интерфейс и один и тот же набор параметров, разница только в наличии image_urls в запросе.

Каждый вызов возвращает одно изображение. Ниже описано в порядке «как считается цена → как заполнять параметры → как отправлять запрос → какие есть ограничения»; все цифры соответствуют определению интерфейса на момент написания статьи.

Цена: оплата по размерному уровню, за референсные изображения — доплата за каждое

Стоимость состоит из двух частей: базовая цена выходного уровня плюс стоимость референсных изображений.

• 1K / 1.5K: $0.0186 / изображение
• 2K (уровень по умолчанию): $0.0325 / изображение
• Референсные изображения: $0.0075 за каждое, первое тоже оплачивается, максимум 10

Несколько примеров:

• 1K, генерация по тексту без референсных изображений: $0.0186
• 2K с 1 референсным изображением: $0.0325 + $0.0075 = $0.04
• 2K с 10 референсными изображениями (предел): $0.0325 + $0.075 = $0.1075

Если не указывать size, изображение генерируется в 2K и оплачивается по тарифу 2K. Если нужны только эскизы или небольшие иллюстрации, явное указание "size": "1K" позволит сэкономить около сорока процентов. При неудаче задачи стоимость возвращается полностью.

Обзор параметров

Кроме model и prompt, все параметры необязательны:

• prompt: обязательный, 1–5000 символов. Описывает генерируемое изображение; при наличии референсных изображений укажите, что нужно изменить и что сохранить.
• size: 1K, 1.5K, 2K, по умолчанию 2K.
• aspect_ratio: 10 вариантов — 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2. Если не указан, модель выбирает автоматически на основе промпта и референсных изображений.
• image_urls: от 1 до 10 общедоступных http(s)-адресов изображений. Если не указаны, выполняется чистая генерация по тексту.
• output_format: png или jpeg, по умолчанию png.
• background: auto, transparent, opaque, по умолчанию auto. При выборе transparent формат вывода может быть только png; в сочетании с jpeg запрос будет отклонён.

Отправка запроса

Задачи изображений на HiAPI асинхронные: сначала создаётся задача, затем запрашивается результат. model указывается на верхнем уровне, остальные параметры помещаются в input.

Генерация по тексту (2K, 16:9):

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "маяк на морском побережье ранним утром, лёгкий туман, мягкий боковой свет, реалистичная фотография",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

Редактирование по референсному изображению (1K, прозрачный фон, PNG):

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "сохранить бутылку и этикетку, убрать фон, заменить на мягкий верхний свет",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

Стоимость этого запроса составит $0.0186 + $0.0075 = $0.0261. После успешного создания возьмите возвращённый ID задачи и опрашивайте GET https://api.hiapi.ai/v1/tasks/{taskId}; когда статус станет «успешно», возьмите адрес изображения из вывода и скачайте его.

Текущие ограничения

• Максимум 2K, уровня 4K нет.
• Не поддерживается послойный вывод изображений.
• Каждый вызов создаёт только одно изображение; для нескольких изображений отправляйте несколько задач параллельно.
• Референсные изображения должны быть общедоступными http(s)-адресами; локальные пути к файлам и base64 не принимаются.
• Прозрачный фон поддерживается только в PNG.

Как выбрать уровень

Для постеров и главных изображений товаров, которые сразу идут в продакшен, используйте 2K по умолчанию; для внутренних черновиков на согласование, массового перебора стилей и небольших миниатюр используйте 1K или 1.5K (они стоят одинаково, 1.5K чётче, поэтому если нет причин выбирать 1K, сразу берите 1.5K). Референсные изображения оплачиваются за каждое, поэтому прикладывайте только те, которые действительно влияют на результат; для изображений одного товара с разных ракурсов сначала попробуйте 1–2 штуки и добавляйте ещё, если результата недостаточно.