개요

SciDraw AI의 REST API는 이미지 생성, 이미지 편집, 형식 변환을 위한 안정적인 작업 기반 엔드포인트를 제공합니다.

기본 URL: https://sci-draw.com

기계 판독용 명세: OpenAPI JSON · OpenAPI YAML

두 파일은 같은 API를 OpenAPI 형식으로 기술한 것입니다. 둘 중 하나를 Postman이나 Insomnia에 가져오면 모든 엔드포인트와 파라미터가 미리 채워지고, 코드 생성기에 넣으면 타입이 있는 클라이언트를 만들 수 있으며, AI 에이전트에 건네주면 요청을 직접 작성하지 않아도 API를 호출할 수 있습니다. 두 형식의 내용은 동일하니 사용하는 도구가 받는 쪽을 고르세요.

빠른 시작

1. 설정 → API 키에서 키를 만들고, 연동에 실제로 필요한 범위만 선택하세요.
2. 키는 Authorization: Bearer sd_... 형태로 보냅니다.
3. 모든 생성 요청에 고유한 Idempotency-Key를 넣으세요.
4. 반환된 작업 ID를 저장하고, Location URL을 succeeded, failed, canceled 중 하나가 될 때까지 폴링하세요.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

생성 요청은 보통 202 Accepted, 작업 객체, Location 헤더, Retry-After: 2를 반환합니다. Prefer: wait=10을 추가하면 최대 10초까지 기다릴 수 있습니다. 기다려도 작업의 동작 자체는 달라지지 않습니다. 작업이 이미 종료 상태일 때만 200이고, 그렇지 않으면 여전히 202입니다.

엔드포인트

모든 응답은 JSON 봉투 구조입니다. 응답마다 X-Request-Id가 있으니 지원을 요청할 때 그 ID를 함께 알려 주세요. 응답에 담기는 파일 참조는 출력 URL과 공개 파일 ID 뿐입니다. 기능 라우팅은 SciDraw AI가 관리합니다.