Seedream

Создание изображений Seedream

Используйте маршрут CometAPI POST /v1/images/generations для генерации изображений Seedream с текстовыми Prompt, референсными изображениями, последовательным выводом изображений и асинхронными задачами.

POST

images

generations

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

Используйте OpenAI-совместимый маршрут CometAPI POST /v1/images/generations для запуска генерации изображений Seedream. Этот endpoint поддерживает Prompt text-to-image, запросы с референсными изображениями и ограниченный последовательный вывод изображений, когда выбранная модель поддерживает такие параметры. На этой странице рассматриваются seedream-5-0-pro-260628 для Pro-запросов text-to-image и seedream-5-0-260128 для примеров с референсными изображениями, последовательной генерацией и асинхронными задачами в Seedream 5.0. Сведения о доступности для аккаунта см. на странице Models или запросите /v1/models. Подробности о параметрах провайдера см. в BytePlus image generation API и руководстве по Seedream 4.0-5.0.

Выберите форму запроса

Text to image: отправьте model, prompt, size и необязательные параметры управления выводом, такие как response_format, output_format и watermark.
Image to image: добавьте image как массив публичных HTTPS URL или data URI. Используйте массив, даже если отправляете одно референсное изображение.
Sequential prompt: установите sequential_image_generation в auto и используйте sequential_image_generation_options.max_images как верхнюю границу. Модель может вернуть меньше изображений, чем максимум.
Async task: добавьте async: true, если хотите, чтобы запрос на создание возвращал data.task_id вместо удержания HTTP-соединения открытым.

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

Запустите асинхронную задачу изображения

Установите async в true для задач генерации изображений, которые ваш клиент должен отправлять и опрашивать. Запрос на создание возвращает data.task_id; используйте это значение с Получением задачи изображения Seedream, пока data.status не станет success или failure. Используйте 2K в асинхронных примерах для запросов Seedream 5.0. Поддержка размеров зависит от model ID, поэтому перед отправкой асинхронной задачи выберите размер, поддерживаемый моделью.

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

Используйте data:image/png;base64,YOUR_BASE64_IMAGE для встроенных данных изображения или публичный HTTPS URL, который провайдер сможет получить. Примеры в API reference показывают полную структуру JSON для каждого типа запроса.

Чтение URL результата

Возвращаемый url — это подписанная ссылка на object storage и может содержать &, % и другие специальные символы. Извлекайте URL из разобранного JSON вместо копирования неполной строки из терминала. В shell-примерах jq -r '.data[]?.url' сохраняет полный подписанный URL.

Авторизации

Authorization

string

header

обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json

Parameters for Seedream image generation. Send JSON for text-to-image, image-to-image, and sequential prompt requests.

model

string

по умолчанию:seedream-5-0-pro-260628

обязательно

Seedream model ID to use. Query /v1/models or open the Models page for available model IDs.

prompt

string

по умолчанию:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.

обязательно

Text prompt describing the image or edit goal. Use a concrete visual request, such as a blue ceramic mug on a white table, soft studio lighting.

response_format

enum<string>

по умолчанию:url

Response image format. Use url for a temporary signed image URL, or b64_json when you need base64 image data in the response.

Доступные опции:

url,

b64_json

size

string

по умолчанию:2K

Output resolution. Use a model-supported tier such as 2K or a model-supported WIDTHxHEIGHT value such as 2048x2048. Not every model ID accepts every tier.

image

string[]

Optional reference images for image-to-image generation. Each item can be a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use an array even for one image. Reference images plus generated images must not exceed the provider limit.

watermark

boolean

по умолчанию:false

When true, requests a visible AI-generated watermark on the output image. Set false when your workflow handles disclosure separately.

async

boolean

по умолчанию:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll the Seedream image task endpoint GET /v1/images/generations/{task_id} for the final image data.

output_format

enum<string>

по умолчанию:png

Output image file format. Use png when you need lossless output, or jpeg for smaller files.

Доступные опции:

png,

jpeg

guidance_scale

number

Optional prompt-adherence control for model versions that support it. Higher values can follow the prompt more closely but may reduce naturalness. Omit this field when you do not need model-specific tuning.

Требуемый диапазон: 1 <= x <= 10

seed

integer

по умолчанию:-1

Optional random seed for reproducible attempts on model versions that support seeding. Use -1 or omit the field for a random seed.

Требуемый диапазон: -1 <= x <= 2147483647

sequential_image_generation

enum<string>

по умолчанию:disabled

Controls sequential prompt handling. Use auto to let the model return a sequence when the prompt calls for one. Use disabled for ordinary single-image requests.

Доступные опции:

auto,

disabled

sequential_image_generation_options

object

Options for sequential prompt handling. This object is only used when sequential_image_generation is auto.

Show child attributes

Ответ

200 - application/json

Image generation response. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

Option 1
Async task response

created

integer

обязательно

Unix timestamp in seconds when the image response was created.

data

object[]

обязательно

Generated image results. The array can contain one or more images depending on the request and model response.

Show child attributes

usage

object

Usage information for the request. Fields vary by model and route.

Show child attributes

Получить prediction Replicate

Получение задачи изображения Seedream

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

Модерация контента

API-ключи

Создание изображений Seedream

Выберите форму запроса

Запустите асинхронную задачу изображения

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

Чтение URL результата

Авторизации

Тело

Ответ

​Выберите форму запроса

​Запустите асинхронную задачу изображения

​Отправьте референсные изображения

​Чтение URL результата

Авторизации

Тело

Ответ

Выберите форму запроса

Запустите асинхронную задачу изображения

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

Чтение URL результата