Створення зображень Seedream

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 для прикладів еталонних зображень, послідовної генерації та async у 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 task для зображення

Установіть async у true для завдань генерації зображень, які клієнт має надсилати та опитувати. Запит на створення повертає data.task_id; використовуйте це значення з Отримання task зображення Seedream, доки data.status не стане success або failure. Використовуйте 2K в async-прикладах для запитів Seedream 5.0. Підтримка розміру залежить від model ID, тому перед надсиланням async task виберіть розмір, який підтримується моделлю.

Надсилання еталонних зображень

Використовуйте 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

Отримати передбачення 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

Виберіть формат запиту

Запуск async task для зображення

Надсилання еталонних зображень

Читання URL виводу

Авторизації

Тіло

Відповідь

​Виберіть формат запиту

​Запуск async task для зображення

​Надсилання еталонних зображень

​Читання URL виводу

Авторизації

Тіло

Відповідь

Виберіть формат запиту

Запуск async task для зображення

Надсилання еталонних зображень

Читання URL виводу