이미지 모델고급 사용자업데이트
POST/v1/images/generations
Seedream 4.5
요청 ID seedream-4-5
프로토콜
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
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 이 모델 ID를 지정하세요 seedream-4-5. |
prompt | string | 필수 | 생성할 이미지의 내용을 설명하세요. |
aspect_ratio | string | 선택 | 출력 이미지의 가로세로 비율입니다. 허용 값 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9, 9:21. 기본값 1:1. 참조 이미지가 있으면 auto도 사용할 수 있습니다. |
image_size | string | 선택 | 출력 해상도 등급입니다. 허용 값 2K, 4K. 기본값 2K. |
n | integer | 선택 | 요청당 이미지 한 장을 생성합니다. 기본값 1. |
image_input | string[] | 선택 | JSON 참조 이미지 배열입니다. 각 항목은 공개 HTTPS 이미지 URL 또는 Base64 이미지 data URL입니다. 호환 필드 image_urls. 참조 이미지 한도 8. |
?async | string | 선택 | URL 쿼리 매개변수입니다. 1, true, yes를 지정하면 202와 task_id를 반환합니다. 생략하면 결과를 기다립니다. |
요청 예시
API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.
예시의 미디어 URL 및 에셋 ID를 유효한 내 에셋으로 바꾸세요.
Images Generations
bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "seedream-4-5",
"prompt": "A watercolor illustration of a paper lantern by a lake.",
"aspect_ratio": "16:9",
"image_size": "2K"
}'
이미지 작업 조회
bash
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입니다.
json
{
"id": "d142c93a-de26-40c9-be62-0de840d10960",
"created": 1781599773,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
HTTP 202 · 비동기 요청 접수
json
{
"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 · 완료 작업 조회
json
{
"task_id": "d142c93a-de26-40c9-be62-0de840d10960",
"status": "completed",
"model": "seedream-4-5",
"result_url": "https://example.com/generated-image.png"
}
주요 오류
조회 결과가 failed이면 error를 확인하세요. error_detail이 있으면 다시 제출하기 전에 retryable을 확인하세요.
전체 연동 가이드 · 요청 필드, 작업 상태 및 응답 형식은 전체 API 가이드를 참고하세요.
기능 및 제한
text_to_image· 지원image_to_image· 조건부 지원 — 지원되는 요청 형식으로 유효한 참조 이미지를 제공해야 합니다image_editing· 공개되지 않음reference_images· 조건부 지원 — 지원되는 요청 형식으로 유효한 참조 이미지를 제공해야 합니다- 제한 참조 이미지: 최대 8개 · 해상도: 2K, 4K · 화면 비율: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9, 9:21