LogoLogoAPI 문서
LogoLogoAPI 문서
홈페이지
개요인증과 멱등성이미지 생성이미지 편집이미지 변환차트 생성작업과 제한 대기크레딧오류요청 제한과 동시 실행API 변경 내역
API 문서

이미지 생성

텍스트로 이미지를 만드는 작업 생성

POST /api/v1/images/generations는 텍스트 설명으로 1~4장의 이미지를 만듭니다. 필요한 범위: images:generate.

JSON 본문

필드타입필수기본값규칙
promptstring예—앞뒤 공백 제거 후 5~2,000자
aspect_ratiostring아니요1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9
resolutionstring아니요2K2K 또는 4K
countinteger아니요11~4

알 수 없는 필드는 거부됩니다. 공개 요청에는 기능 라우팅 옵션이 없습니다.

크레딧

해상도장당 크레딧
2K5
4K20

예약되는 총량은 장당 비용에 count를 곱한 값입니다. 크레딧은 작업이 접수될 때 원자적으로 예약되고, 성공하면 정산되며, 종료 상태로 실패하면 해제됩니다.

cURL

인증과 멱등성

API 키, 범위, 요청 ID, 안전한 재시도

이미지 편집

업로드한 이미지를 자연어 지시로 편집하기

목차

JSON 본문
크레딧
cURL
JavaScript
Python
출력 크기
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_ratio2K4K
1:12048×20482880×2880
16:92560×14403840×2160
9:161440×25602160×3840
4:32304×17283264×2448
3:41728×23042448×3264
3:22496×16643504×2336
2:31664×24962336×3504
5:42240×17923200×2560
4:51792×22402560×3200
21:93136×13443808×1632