Skip to main content
POST
cURL
Використовуйте POST /v1/images/generations з async: true, щоб надіслати завдання зі створення зображення Seedream, не утримуючи HTTP-з’єднання відкритим. Цей асинхронний робочий процес застосовується до таких ID моделей: Щоб дізнатися про доступність для облікового запису, перегляньте сторінку Моделі або виконайте запит до /v1/models. Докладніше про параметри постачальника див. в BytePlus API створення зображень та посібник із Seedream 4.0-5.0.

Надішліть завдання

Надішліть model, prompt і async: true. У прикладі також запитується URL-відповідь 2K за допомогою watermark: false. Підтримка розмірів залежить від ID моделі, тому використовуйте розмір, який підтримує вибрана модель. Відповідь на створення повертає data.task_id, data.status та порожній масив data.data, поки завдання очікує на виконання. Збережіть data.task_id; не використовуйте код відповіді верхнього рівня як ідентифікатор завдання.

Опитуйте завдання

Передайте збережений ID завдання в запит Отримати завдання зі створення зображення Seedream. Продовжуйте опитування, доки data.status має значення pending. Зупиніть його, коли значення стане success або failure.

Отримайте URL зображення

Коли завдання успішно виконується, прочитайте data.data[0].url з розібраного JSON. В оболонці jq -r '.data.data[0].url' зберігає спеціальні символи в повному URL.Негайно завантажте або передайте зображення. URL є тимчасовим; у цій документації не передбачається фіксований строк дії.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json
model
string
обов'язково

Seedream model ID. This async workflow is documented for doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-5-0-260128, and seedream-5-0-pro-260628. Query /v1/models or open the Models page for account availability.

Приклад:

"doubao-seedream-5-0-260128"

prompt
string
обов'язково

Text prompt describing the image to generate.

Приклад:

"A clean studio photograph of a small red ceramic teapot on a pale blue table, soft window light, no text."

async
boolean
обов'язково

Asynchronous task mode. Set this to true, store data.task_id, and poll the task endpoint.

size
string

Requested output size. Use a value supported by the selected model.

Приклад:

"2K"

response_format
string

Response workflow for this async request. The example uses url and retrieves the URL from the completed task.

Приклад:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Приклад:

false

Відповідь

200 - application/json

Seedream asynchronous task submission response.

code
string
обов'язково

Request status code. A successful submission returns success.

Приклад:

"success"

message
string
обов'язково

Status message. A successful submission can return an empty string.

data
object
обов'язково
Останнє оновлення 31 липня 2026 р.