Seedream-5.5 이미지 생성 | ToAPIs Documentation

POST

/v1/images/generations

중국 본토 사용자 안내: 중국 본토 사용자는 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_KEY

Body

modelstring본문필수기본값: doubao-seedream-5-5

Image generation model name

Example: "doubao-seedream-5-5"

promptstring본문

일반 생성과 편집에 필요한 텍스트 설명. layer_decomposition 을 켜면 생략할 수 있으며, 모델이 분해할 요소를 자동으로 결정합니다.

sizestring본문기본값: 2K

1K, 1.5K, 2K 또는 2048x2048 같은 WIDTHxHEIGHT 픽셀 크기를 지원합니다. 프리셋은 해상도 등급이며 종횡비를 고정하지 않습니다. 지정한 크기의 총 픽셀 수는 921600-4624220 이어야 합니다. 정사각형에는 1:1 대신 2048x2048 을 사용하세요. 일반 생성의 기본값은 2K 입니다. 레이어 분해에는 2K 를 명시하세요.

image_urlsstring[]본문

이미지 편집 또는 여러 이미지 참조에 사용하는 이미지 URL 배열.

참조 이미지 최대 10장.
공개적으로 접근 가능한 HTTP/HTTPS URL만 지원하며, base64 데이터 직접 입력은 지원하지 않습니다.
로컬 이미지는 먼저 이미지 업로드 API로 업로드하세요.
reference_images 또는 images 배열도 사용할 수 있습니다.

imagestring본문

참조 이미지 한 장의 URL 문자열. 여러 이미지에는 image_urls 를 사용하고, image 에 배열을 넣지 마세요.

layer_decompositionboolean본문

true 로 설정하면 참조 이미지 한 장을 분해합니다. prompt 는 생략할 수 있습니다. 연속 이미지 생성 파라미터는 생략하세요. 기본 이미지와 투명 PNG 레이어를 반환하며 z_index, 위치 정보, 이름을 포함합니다. 현재 API 는 기본 이미지 1 장과 최대 16 개 레이어를 처리합니다. 레이어 수와 OCR 설정은 제공하지 않습니다.

optimize_prompt_optionsobject본문

프롬프트 최적화 설정. {"mode": "standard"} 를 사용하세요. Seedream 5.5 는 fast 를 받지 않습니다.

metadataobject본문

Channel-specific parameters for advanced Seedream 5.5 model configuration

metadata properties

metadata.output_formatstring본문기본값: png

출력 형식은 png 또는 jpeg 입니다. 투명 배경에는 png 를 사용하세요.

metadata.backgroundstring본문

opaque 또는 transparent 를 받습니다. 투명 배경과 output_format=jpeg 는 함께 사용할 수 없습니다. transparent 에서 형식을 생략하면 PNG 를 사용합니다. 현재 API 는 명시적인 auto 값을 받지 않습니다.

metadata.watermarkboolean본문기본값: false

표시되는 AI generated 워터마크를 제어합니다. false 는 끄고 true 는 켭니다. 출처 메타데이터나 보이지 않는 표식의 제거를 의미하지 않습니다.

metadata.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

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

모델 name used

statusstring

Task status

queued - Queued for processing
in_progress - Processing
completed - Successfully completed
failed - Failed

progressinteger

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

Task metadata

result.dataarray

완료된 이미지 목록. 일반 생성은 한 항목, 레이어 분해는 여러 항목입니다.

result.data[]object

이미지 URL, 실제 픽셀 크기, 출력 형식.

result.data[].z_indexinteger

레이어 쌓임 순서. 0 은 기본 이미지입니다. 다른 레이어에는 bounding_box, name, description 이 포함될 수 있습니다.

실행 전에 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,
  "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"
      }
    ]
  }
}