switch_heading
Seedream 5 Pro
/v1/images이미지 생성 API
Seedream 5 Pro로 텍스트에서 이미지를 생성하거나 최대 10개의 참조 이미지를 편집하세요.
모델 별칭
seedream-5-pro
입력 모드
텍스트 또는 참조
기본 가격
9 / 18 credits
빠른 시작
작업을 만든 뒤 SUCCESS 또는 FAILED가 될 때까지 상태를 조회합니다.
bash
| 1 | curl -X POST 'https://seedanceapi.org/v1/images/generations' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedream-5-pro", |
| 6 | "prompt": "A cinematic product photo on a reflective surface", |
| 7 | "aspect_ratio": "1:1", |
| 8 | "resolution": "1k", |
| 9 | "image_urls": [] |
| 10 | }' |
요청 수명 주기
- 01
인증
기존 Seedance API 키를 Bearer 헤더에 사용합니다.
- 02
작업 생성
생성 요청을 보내고 API가 반환한 task ID를 저장합니다.
- 03
결과 조회
task ID로 상태를 조회하며 성공 이미지는 자체 CDN URL로 반환됩니다.
인증
모든 이미지 엔드포인트는 Seedance API 키가 필요하며 공급자 정보는 노출되지 않습니다.
http
| 1 | Authorization: Bearer YOUR_API_KEY |
| 2 | Content-Type: application/json |
가격
제품 가격은 공급자 라우팅과 무관합니다.
| 해상도 | 기본 비용 | 추가 참조 |
|---|---|---|
| 1K | 9 credits | 두 번째 이미지부터 장당 +0.8 credits |
| 2K | 18 credits | 두 번째 이미지부터 장당 +0.8 credits |
엔드포인트
POST
/v1/images/generationsimage_urls가 비어 있으면 텍스트 생성, 1~10개 URL이면 참조 편집입니다.
Body ParametersJSON
model:string
seedream-5-pro여야 합니다.
prompt:string
최대 3000자의 프롬프트입니다.
aspect_ratio:optional string
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 또는 3:2. Defaults to 1:1.
resolution:optional string
1k 또는 2k. Defaults to 1k.
image_urls:optional string[]
공개 HTTPS URL 최대 10개.
텍스트 이미지 요청
json
| 1 | { |
| 2 | "model": "seedream-5-pro", |
| 3 | "prompt": "A cinematic product photo on a reflective surface", |
| 4 | "aspect_ratio": "1:1", |
| 5 | "resolution": "1k", |
| 6 | "image_urls": [] |
| 7 | } |
참조 이미지 편집
json
| 1 | { |
| 2 | "model": "seedream-5-pro", |
| 3 | "prompt": "Place this product in a minimal studio scene", |
| 4 | "aspect_ratio": "4:3", |
| 5 | "resolution": "2k", |
| 6 | "image_urls": [ |
| 7 | "https://cdn.example.com/reference.png" |
| 8 | ] |
| 9 | } |
HTTP 202
json
| 1 | { |
| 2 | "task_id": "n30c6f2...seed", |
| 3 | "status": "IN_PROGRESS", |
| 4 | "model": "seedream-5-pro", |
| 5 | "estimated_credits": 9 |
| 6 | } |
GET
/v1/images/generations/:task_id생성 시 반환된 task ID로 최신 작업 상태를 조회합니다.
bash
| 1 | curl 'https://seedanceapi.org/v1/images/generations/n30c6f2...seed' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
SUCCESS
json
| 1 | { |
| 2 | "task_id": "n30c6f2...seed", |
| 3 | "status": "SUCCESS", |
| 4 | "model": "seedream-5-pro", |
| 5 | "images": [ |
| 6 | { "url": "https://cdn44.gogloai.com/results/image.png" } |
| 7 | ], |
| 8 | "consumed_credits": 9, |
| 9 | "created_at": "2026-07-13 10:00:00" |
| 10 | } |
FAILED
json
| 1 | { |
| 2 | "task_id": "n30c6f2...seed", |
| 3 | "status": "FAILED", |
| 4 | "model": "seedream-5-pro", |
| 5 | "consumed_credits": 0, |
| 6 | "error": { |
| 7 | "code": "GENERATION_FAILED", |
| 8 | "message": "Image generation failed." |
| 9 | } |
| 10 | } |
오류
| HTTP | Code | 의미 |
|---|---|---|
| 400 | INVALID_* | 요청 매개변수가 잘못되었습니다. |
| 401 | INVALID_API_KEY | API 키가 없거나 잘못되었습니다. |
| 402 | INSUFFICIENT_CREDITS | credits가 부족합니다. |
| 404 | TASK_NOT_FOUND | 작업을 찾을 수 없습니다. |
| 502 / 503 | UPSTREAM_* | 이미지 서비스를 일시적으로 사용할 수 없습니다. |