Seedream 5 이미지 API

API 문서

이 엔드포인트로 Seedream 5 이미지를 비동기 생성할 수 있습니다. 크레딧은 품질과 모드에 따라 달라집니다.

인증

모든 요청은 API 키를 헤더에 포함해야 합니다. Authorization header:

Authorization: Bearer <YOUR_API_KEY>

누락되거나 유효하지 않은 키는 반환됩니다. 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

생성 작업 생성

새로운 Seedream 5 작업을 제출합니다. 호출은 렌더링이 비동기적으로 완료되는 동안 즉시 task_id 를 반환합니다.

매개변수	유형	필수	설명
prompt	string (max 1500 chars)	예	기본 텍스트 설명(최대 1500자). 모든 요청에 필수입니다.
aspectRatio	string	예	지원 비율: 1:1 · 3:4 · 4:3 · 9:16 · 16:9.
quality	string (basic \| high)	예	basic(빠른 2K) 또는 high(고화질 4K).
imageUrls	string[]	아니요	선택적 참조 이미지. 편집 모드에서는 필수입니다.

크레딧 소비

크레딧은 작업이 생성될 때 차감됩니다. 실패한 작업은 자동으로 환불됩니다.

사전 설정	차감된 크레딧
텍스트 이미지 생성 · Basic	12
텍스트 이미지 생성 · High	18
참조 이미지 편집 · Basic	18
참조 이미지 편집 · High	24
4장 연속 생성(단일 호출)	48

요청 예시

POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
  "aspectRatio": "4:3",
  "quality": "high",
  "imageUrls": []
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71"
  }
}

GET / POST

https://seedream45ai.org/api/status

작업 상태 확인

이 엔드포인트를 사용하여 최신 기록을 폴링하세요. 작업이 여전히 IN_PROGRESS(진행 중) 상태일 때는 응답하기 전에 공급자에게 한 번 더 쿼리합니다.

매개변수	유형	필수	설명
task_id	string	예	/generate에서 반환된 ID. /status 호출 시 쿼리(?task_id=)로 전달합니다.

필드	설명
task_id	/generate에서 반환된 ID.
status	SUCCESS (성공)
request	제출된 페이로드의 정리된 복사본.
response	상태가 SUCCESS일 때의 미디어 URL 배열.
consumed_credits	작업에 청구된 크레딧 (환불 시 0).
error_message	상태가 FAILED일 때의 공급자 오류 메시지.
created_at	작업이 저장된 UTC 타임스탬프.

요청 예시

GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71",
    "status": "SUCCESS",
    "request": {
      "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
      "aspectRatio": "4:3",
      "quality": "high"
    },
    "response": [
      "https://watch_001.png"
    ],
    "consumed_credits": 12,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

오류 처리

401 Unauthorized - API 키 누락 또는 유효하지 않음.
402 Payment Required - 크레딧 잔액이 차감액을 충당할 수 없음.
429 Too Many Requests - 폴링 간격 또는 요청 속도를 줄이십시오.
500 - 일시적인 문제; 지수 백오프를 사용하여 다시 시도하십시오.