공개 이미지 API
논문에 바로 쓸 수 있는 과학 도해를 여러분의 애플리케이션 안에서 생성·편집·변환하세요.
크레딧은 웹과 같은 것을 씁니다. 요금제 페이지에서 구매하세요.
curl https://sci-draw.com/api/v1/images/generations \
-H 'Authorization: Bearer sd_YOUR_KEY' \
-H 'Idempotency-Key: figure-7842-v1' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "Clean scientific illustration of exosome biogenesis",
"aspect_ratio": "16:9",
"resolution": "2K",
"count": 1
}'curl https://sci-draw.com/api/v1/images/generations \
-H 'Authorization: Bearer sd_YOUR_KEY' \
-H 'Idempotency-Key: figure-7842-v1' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "Clean scientific illustration of exosome biogenesis",
"aspect_ratio": "16:9",
"resolution": "2K",
"count": 1
}'API 전용 등급도, 멤버십 조건도, 최소 결제 금액도 없습니다.
설정 → API 키에서 필요한 범위만 고르세요. 키는 sd_로 시작하고 한 번만 표시됩니다.
키를 bearer 토큰으로 보내고, 반환된 작업 ID를 저장한 뒤 끝날 때까지 폴링하세요.
POST /v1/images/generations
prompt를 보내면 2K 또는 4K 이미지를 반환합니다. 요청당 최대 4장.
POST /v1/images/edits
multipart/form-data로 원본 이미지와 prompt를 올리면 편집된 이미지를 반환합니다.
POST /v1/images/conversions
래스터 이미지를 올리면 SVG, PPTX, PNG, PDF, TIFF를 반환합니다.
GET /v1/jobs/{id} · GET /v1/credits
작업 ID로 상태, 소진 크레딧, 출력 파일 URL을 조회합니다. 계정 잔액도 조회합니다.
작업 종류별로 가격이 고정입니다. 접수 시 크레딧을 예약하고 성공하면 한 번 정산합니다.
| 작업 | 크레딧 |
|---|---|
| 생성, 2K | 장당 5 |
| 생성, 4K | 장당 20 |
| 편집, 2K | 장당 10 |
| 편집, 4K | 장당 20 |
| SVG 변환, 텍스트 편집 가능 | 건당 10 |
| SVG 변환, 완전 벡터 | 건당 15 |
| PPTX 변환 | 건당 10 |
| 래스터 변환, 300 / 600 / 1000 DPI | 건당 5 – 15 |
구독 크레딧은 매달 갱신되고, 구매한 패키지는 만료되지 않으며, 실패한 작업은 전액 되돌아갑니다.
요금제와 크레딧 패키지 보기한도를 넘기면 429 RATE_LIMIT_EXCEEDED를 반환합니다. 지수 백오프로 재시도하고 그동안 멱등성 키는 그대로 두세요.
통일된 스타일로 도해 세트를 한꺼번에 만들고, SVG나 고해상도 출력을 제작 공정에 바로 투입.
사용자가 서비스 안에서 도해를 만들게 하세요. 작업은 유실되지 않고 요청 스레드를 붙잡지 않습니다.
실험 프로토콜, 교육 자료, 사내 문서용 도해 생성을 스크립트로 자동화.
아닙니다. 로그인한 계정이면 누구나 키를 만들 수 있고, 신규 계정은 첫 호출용 지급 크레딧을 받습니다.
별개가 아닙니다. 계정당 잔액은 하나이고, 웹과 API가 같은 크레딧을 씁니다.
전액 해제됩니다. 성공 시 정확히 한 번만 정산되고, 내부 재시도가 두 번 예약하지 않습니다.
구독 크레딧은 매달 갱신, 구매 패키지는 무기한, 지급 크레딧은 하루 만에 소멸합니다. API는 만료가 임박한 것부터 씁니다.
사용량과 호출 빈도를 알려 주세요. 이 수치는 기본값이지 상한이 아닙니다.
키를 만들고 위 curl을 붙여 넣으면 몇 초 안에 작업 ID를 받습니다.
