API 문서API 문서
이미지 생성
텍스트로 이미지를 만드는 작업 생성
POST /api/v1/images/generations는 텍스트 설명으로 1~4장의 이미지를 만듭니다.
필요한 범위: images:generate.
JSON 본문
| 필드 | 타입 | 필수 | 기본값 | 규칙 |
|---|---|---|---|---|
prompt | string | 예 | — | 앞뒤 공백 제거 후 5~2,000자 |
aspect_ratio | string | 아니요 | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9 |
resolution | string | 아니요 | 2K | 2K 또는 4K |
count | integer | 아니요 | 1 | 1~4 |
알 수 없는 필드는 거부됩니다. 공개 요청에는 기능 라우팅 옵션이 없습니다.
크레딧
| 해상도 | 장당 크레딧 |
|---|---|
2K | 5 |
4K | 20 |
예약되는 총량은 장당 비용에 count를 곱한 값입니다. 크레딧은 작업이 접수될 때
원자적으로 예약되고, 성공하면 정산되며, 종료 상태로 실패하면 해제됩니다.
cURL
curl https://sci-draw.com/api/v1/images/generations \
-H 'Authorization: Bearer sd_YOUR_KEY' \
-H 'Idempotency-Key: manuscript-42-panel-a' \
-H 'Prefer: wait=10' \
-H 'Content-Type: application/json' \
-d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'JavaScript
const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
'Idempotency-Key': crypto.randomUUID(),
'Content-Type': 'application/json',
},
body: JSON.stringify({ prompt: 'A labeled plant cell diagram' }),
});
const body = await response.json();Python
import os, uuid, requests
response = requests.post(
"https://sci-draw.com/api/v1/images/generations",
headers={
"Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={"prompt": "A labeled plant cell diagram", "resolution": "2K"},
)
job = response.json()["data"]대기 중이거나 처리 중이면 202를, 대기 시간 안에 종료 상태에 도달하면 200을
반환합니다. 응답 스키마와 폴링 흐름은 작업을 참고하세요.
출력 크기
2K와 4K는 크기 등급이며 고정된 변 길이가 아닙니다. 표는 실제 출력 픽셀 크기입니다. 지원하지 않는 비율은 작업 생성이나 크레딧 예약 전에 HTTP 400 (INVALID_REQUEST)을 반환합니다.
aspect_ratio | 2K | 4K |
|---|---|---|
| 1:1 | 2048×2048 | 2880×2880 |
| 16:9 | 2560×1440 | 3840×2160 |
| 9:16 | 1440×2560 | 2160×3840 |
| 4:3 | 2304×1728 | 3264×2448 |
| 3:4 | 1728×2304 | 2448×3264 |
| 3:2 | 2496×1664 | 3504×2336 |
| 2:3 | 1664×2496 | 2336×3504 |
| 5:4 | 2240×1792 | 3200×2560 |
| 4:5 | 1792×2240 | 2560×3200 |
| 21:9 | 3136×1344 | 3808×1632 |