Seedream 5.5 AI

개발자 문서

Seedream 5 Pro API 문서

이 사이트의 비동기 API로 Seedream 5 Pro 이미지를 생성하세요. Seedream 5.5는 프리뷰 단계이며 아직 여기서 호출할 수 없습니다.

빠른 시작

  1. 작업 공간의 API 키 관리 화면에서 키를 만드세요.
  2. model=seedream-5-pro와 프롬프트를 POST /api/v1/images/generate로 보내세요.
  3. 반환된 data.task_id와 같은 API 키로 GET /api/v1/images/status?task_id=TASK_ID를 반복 조회하세요.

인증

서버에서 Authorization: Bearer YOUR_API_KEY를 보내세요. 브라우저 로그인 세션이나 Cookie는 필요하지 않습니다. API 키는 비공개로 보관하세요.

Authorization: Bearer YOUR_API_KEY

엔드포인트 및 요청 필드

POST /api/v1/images/generate

model, prompt, aspect_ratio, resolution(1k 또는 2k)을 담은 JSON 본문을 보내세요. 선택 필드 image_urls에는 최대 10개의 참조 이미지 URL을 넣을 수 있으며 public은 선택적인 불리언 값입니다. 응답에는 code, message와 task_id 및 status를 담은 data가 포함됩니다.

GET /api/v1/images/status?task_id=TASK_ID

task_id로 조회하면 code, message와 task_id, status, consumed_credits, image_urls(이미지 URL 배열)를 담은 data를 반환합니다. 작업 실패 시 error_message가 포함될 수 있습니다.

호출할 수 있는 유일한 모델: seedream-5-pro

처리 중에는 계속 조회하고, 완료되면 image_urls를 확인하세요. 실패하면 error_message를 확인하세요.

cURL 예제

명령을 터미널에 복사하고 YOUR_API_KEY를 비공개 API 키로 바꾼 다음 TASK_ID를 첫 응답의 data.task_id로 바꾸세요.

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"선명하고 읽기 쉬운 글자가 있는 카페 포스터","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'