이미지 생성

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'

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']}"

대기 중이거나 처리 중이면 202를, 대기 시간 안에 종료 상태에 도달하면 200을 반환합니다. 응답 스키마와 폴링 흐름은 작업을 참고하세요.

JSON 본문

크레딧

cURL

JavaScript

Python

목차