Skip to main content
POST
cURL
HTTP 연결을 계속 열어 두지 않고 Seedream 이미지 작업을 제출하려면 POST /v1/images/generations에서 async: true를 사용하세요. 이 비동기 워크플로는 다음 모델 ID에 적용됩니다: 계정에서의 사용 가능 여부는 모델 페이지 를 참조하거나 /v1/models를 조회하세요. 공급자 파라미터 세부 정보는 BytePlus의 이미지 생성 APISeedream 4.0-5.0 튜토리얼.

작업 제출

model, promptasync: true를 전송하세요. 예제에서는 2Kwatermark: false를 사용하여 URL 응답도 요청합니다. 지원되는 크기는 모델 ID에 따라 다르므로 선택한 모델에서 지원하는 크기를 사용하세요. 생성 응답은 작업이 대기 중인 동안 data.task_id, data.status 및 빈 data.data 배열을 반환합니다. data.task_id을 저장하세요. 최상위 응답 코드를 작업 식별자로 사용하지 마세요.

작업 폴링

저장된 작업 ID를 다음에 전달하세요 Seedream 이미지 작업 조회. data.status 값이 pending인 동안 계속 폴링하세요. success 또는 failure가 되면 중지하세요.

이미지 URL 읽기

작업이 성공하면 파싱된 JSON에서 data.data[0].url을 읽으세요. 셸에서는 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
필수
마지막 수정일 2026년 7월 31일