Seedream-5.5 이미지 생성
Seedream 5.5 이미지 생성 및 편집. 1K/1.5K/2K, 투명 PNG, 레이어 분해 지원
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
doubao-seedream-5-5 로 텍스트 기반 생성, 참조 이미지 편집, 레이어 분해를 요청합니다. 제출 시 반환되는 작업 ID 로 결과를 조회하세요.
일반 생성은 이미지 한 장을 반환하고, 레이어 분해는 기본 이미지와 레이어를 반환합니다.
Authorizations
Authorizationstring헤더필수All endpoints require Bearer Token authentication
Get your API Key from the API Key Management Page
Add to request header:
Authorization: Bearer YOUR_API_KEYBody
modelstring본문필수기본값: doubao-seedream-5-5Image generation model name
Example: "doubao-seedream-5-5"
promptstring본문일반 생성과 편집에 필요한 텍스트 설명. layer_decomposition 을 켜면 생략할 수 있으며, 모델이 분해할 요소를 자동으로 결정합니다.
sizestring본문1K, 1.5K, 2K 해상도 등급 또는 2048x2048 같은 픽셀 크기를 지정할 수 있습니다. 등급은 종횡비를 고정하지 않으며 일반 생성의 지정 크기는 총 921600-4624220 픽셀 범위입니다. 일반 생성은 모델 기본 해상도 (설정이 없으면 2K) 를 사용하며 레이어 분해에서 생략하면 auto 입니다. 이 페이지 예제는 2K 를 명시적으로 지정합니다.
레이어 분해는 auto, 1K, 1.5K, 2K 만 지원하며 원본 비율을 유지합니다. 픽셀 크기를 직접 지정할 수 없습니다. 일반 생성에서 직접 지정한 크기의 가로 대 세로 비율은 1/16 부터 16 사이여야 합니다.
ninteger본문기본값: 1일반 출력 이미지 1 장에 대해 1 을 사용하거나 생략하세요. 레이어 수가 아니므로 레이어 분해에서도 생략하거나 1 을 사용해야 합니다.
image_urlsstring[]본문이미지 편집 또는 여러 이미지 참조에 사용하는 이미지 URL 배열.
- 참조 이미지 최대 10장.
- 공개적으로 접근 가능한 HTTP/HTTPS URL만 지원하며, base64 데이터 직접 입력은 지원하지 않습니다.
- 로컬 이미지는 먼저 이미지 업로드 API로 업로드하세요.
reference_images또는images배열도 사용할 수 있습니다.- 참조 이미지 한 장의 최대 크기는 30 MB 입니다. 레이어 분해는 JPEG 또는 PNG 참조 이미지만 지원합니다.
imagestring본문참조 이미지 한 장의 URL 문자열. 여러 이미지에는 image_urls 를 사용하고, image 에 배열을 넣지 마세요.
layer_decompositionboolean본문기본값: false일반 텍스트 이미지 생성과 이미지 편집에서는 이 파라미터를 생략하거나 false 로 설정하세요. 활성화한 상태에서 참조 이미지가 없거나 여러 장이면 잘못된 요청입니다.
true 로 설정하면 참조 이미지 한 장을 분해합니다. prompt 는 생략할 수 있습니다. 연속 이미지 생성 파라미터는 생략하세요. 기본 이미지와 투명 PNG 레이어를 반환하며 z_index, 위치 정보, 이름을 포함합니다.
layer_decomposition_optionsobject본문layer_decomposition=true 일 때만 사용합니다. max_images 는 2 부터 100 까지의 정수이며 기본 이미지를 포함한 전체 출력 수의 상한입니다. 기본값은 30 이며 실제 수량은 모델이 결정하므로 상한보다 적을 수 있습니다. text_recognition 은 불리언이며 기본값은 false 입니다. 이 객체는 metadata.layer_decomposition_options 에도 지정할 수 있습니다.
optimize_prompt_optionsobject본문프롬프트 최적화 설정. {"mode": "standard"} 를 사용하세요. Seedream 5.5 는 fast 를 받지 않습니다.
metadataobject본문Channel-specific parameters for advanced Seedream 5.5 model configuration
metadata properties
output_formatstring본문기본값: pngpng 또는 jpeg 를 지원하며 기본값은 png 입니다. 투명 배경에는 PNG 가 필요하며 JPEG 는 사용할 수 없습니다. 레이어 모드에서는 기본 이미지에만 적용되고 다른 레이어는 항상 투명 PNG 입니다.
backgroundstring본문layer_decomposition=true 일 때는 background 를 완전히 생략해야 하며 opaque 도 지정할 수 없습니다. 이 파라미터는 일반 이미지 생성과 편집에서만 지원됩니다.
auto, opaque 또는 transparent 를 받습니다. 투명 배경과 output_format=jpeg 는 함께 사용할 수 없습니다. transparent 에서 형식을 생략하면 PNG 를 사용합니다.
일반 생성에서 생략하면 기본값은 auto 이며 모델이 프롬프트와 출력 형식에 따라 투명 여부를 결정합니다. JPEG 출력은 항상 불투명합니다.
watermarkboolean본문기본값: false표시되는 AI generated 워터마크를 제어합니다. false 는 끄고 true 는 켭니다. 출처 메타데이터나 보이지 않는 표식의 제거를 의미하지 않습니다.
response_formatstring본문기본값: url이 페이지는 url 모드를 사용합니다. 비동기 작업 결과에서 이미지 URL 을 가져오세요.
파라미터 제한
일반 다중 이미지 생성은 지원하지 않습니다. sequential_image_generation 과 sequential_image_generation_options 를 생략하세요. disabled 도 상위 API 에서 거부됩니다. stream=true 는 지원하지 않습니다. stream 을 생략하거나 false 를 사용하세요. 현재 API 는 tools 웹 검색과 seed 를 지원하지 않습니다.
작업 조회
제출 성공은 생성 완료를 의미하지 않습니다. 같은 API Key 로 작업을 조회하세요. 상태는 pending, queued, in_progress, completed, failed 중 하나입니다. 완료 시 result.data, 실패 시 error 를 확인하세요.
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"Response
idstringUnique task identifier for status queries
objectstringObject type, always generation.task
modelstring모델 name used
statusstringTask status
pending,queued- Queued for processingin_progress- Processingcompleted- Successfully completedfailed- Failed
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask metadata
result.dataarray완료된 이미지 목록. 일반 생성은 한 항목, 레이어 분해는 여러 항목입니다.
result.data[]object이미지 URL, 실제 픽셀 크기, 출력 형식.
result.data[].z_indexinteger레이어 쌓임 순서. 0 은 기본 이미지입니다. 다른 레이어에는 bounding_box, name, description 이 포함될 수 있습니다.
result.data[].backgroundstring제공자가 반환한 실제 배경 유형: opaque 또는 transparent. 레이어 분해의 기본 이미지는 opaque, 나머지 레이어는 transparent 입니다. 이전 작업이나 해당 정보를 제공하지 않는 모델에서는 생략됩니다.
result.data[].text_recognitionobject제공자가 결과를 반환한 경우에만 해당 레이어의 문자 인식 결과가 포함됩니다. text_recognition 을 활성화해도 이 필드는 생략될 수 있습니다.
객체에는 전체 text 와 행 정보 lines 가 포함됩니다. 각 행에는 bounding_box 와 runs 가 있으며, runs[].style 은 제공자가 반환한 글꼴, 색상 등의 정보를 유지합니다.
실행 전에 TOAPIS_API_KEY 환경 변수를 설정하세요. 예제의 example.com 참조 주소는 자리표시자이므로 접근 가능한 이미지 URL 로 바꾸세요.
요청 예시
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"prompt": "A red toy sailboat and a small yellow sun, isolated objects, no text.",
"size": "2K",
"metadata": {
"output_format": "png",
"background": "transparent",
"watermark": false,
"response_format": "url"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"prompt": "Combine the subjects from both references into one product illustration.",
"size": "2K",
"image_urls": [
"https://example.com/reference-front.png",
"https://example.com/reference-side.jpg"
],
"metadata": {
"output_format": "png",
"watermark": false,
"response_format": "url"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"image": "https://example.com/composition.png",
"layer_decomposition": true,
"layer_decomposition_options": {"max_images": 30, "text_recognition": true},
"size": "2K",
"metadata": {
"output_format": "png",
"watermark": false,
"response_format": "url"
}
}'응답 예시
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "doubao-seedream-5-5",
"status": "pending",
"progress": 0,
"created_at": 1794300000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "doubao-seedream-5-5",
"status": "completed",
"progress": 100,
"created_at": 1794300000,
"metadata": {},
"result": {
"type": "image",
"data": [
{
"url": "https://files.toapis.com/images/example/seedream-5-5.png",
"size": "2512x1680",
"output_format": "png"
}
]
}
}