Doubao Seedream 5.0 Lite

요청 ID doubao-seedream-5-0-lite

프로토콜

• POST /v1/images/generations · 이미지 생성 예시
• GET /v1/images/tasks/{task_id} · 이미지 작업 조회 예시

인증

요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.

• Authorization: Bearer YOUR_API_KEY

요청 매개변수

POST /v1/images/generations

요청 예시

API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.

예시의 미디어 URL 및 에셋 ID를 유효한 내 에셋으로 바꾸세요.

Images Generations

curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "doubao-seedream-5-0-lite",
  "prompt": "A watercolor illustration of a paper lantern by a lake."
}'

이미지 작업 조회

curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

응답 및 작업

HTTP 200 · 동기 요청 성공

?sync=1을 사용하면 data[].url에서 생성한 이미지 URL을 읽을 수 있습니다. created는 Unix 초 타임스탬프이며 id는 작업 ID입니다.

{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 비동기 요청 접수

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

?async=1을 사용하면 같은 API 키로 GET /v1/images/tasks/{task_id}를 반복 조회하세요. status는 pending, completed 또는 failed입니다. 완료되면 result_url에서 이미지 URL을 읽으세요.

HTTP 200 · 완료 작업 조회

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "doubao-seedream-5-0-lite",
  "result_url": "https://example.com/generated-image.png"
}

주요 오류

조회 결과가 failed이면 error를 확인하세요. error_detail이 있으면 다시 제출하기 전에 retryable을 확인하세요.

응답 예제와 오류

전체 연동 가이드 · 요청 필드, 작업 상태 및 응답 형식은 전체 API 가이드를 참고하세요.

기능 및 제한

• text_to_image · 지원
• image_to_image · 조건부 지원 — 지원되는 요청 형식으로 유효한 참조 이미지를 제공해야 합니다
• image_editing · 공개되지 않음
• reference_images · 조건부 지원 — 지원되는 요청 형식으로 유효한 참조 이미지를 제공해야 합니다

호환 별칭 및 은퇴 리디렉션

• doubao-seedream-5.0-lite → doubao-seedream-5-0-lite (별칭)

모델 기능 카탈로그 · 가격 보기