빠른 시작

SpicyAPI는 이미지·영상 생성을 위한 비동기 작업 API와 /v1/chat/completions를 통한 일반 응답·스트리밍 텍스트 생성을 제공합니다. 아래의 세 단계로 첫 생성을 실행할 수 있습니다.

API

GET /api/v1/models?includeSchema=1&includeExamples=1
# choose an item where enabled && available

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: render-001" \
  -d '{
    "model": "MODEL_ID_FROM_CATALOG",
    "input": { "prompt": "a folded paper lantern, hard side light" }
  }'

SDK로 제출부터 결과 대기까지

SDK의 client.run(payload, options)은 작업 제출과 결과 대기를 한 번의 함수 호출로 묶습니다. HTTP 요청이 한 번만 발생한다는 뜻은 아닙니다. 기본 폴링 간격은 약 2초에서 최대 10초까지 늘어납니다. 운영 환경에서는 webhook을 우선 사용하고 준비된 output.assets[].url을 직접 이용하세요.

1. API 키 준비

콘솔에서 키를 만들고 서버 환경 변수 SPICY_API_KEY에 보관하세요. 브라우저, 모바일 앱, 공개 저장소에는 키를 넣지 마세요.

2. 작업 생성

POST /api/v1/jobs/createTask에 model과 input을 보냅니다. 응답의 data.taskId는 상태 조회, 재시도, 다운로드에 사용합니다. 수락된 작업은 취소할 수 없습니다.

3. 결과 수신

운영 환경에서는 webhook을 우선 사용하고 GET /api/v1/jobs/recordInfo를 복구용 폴링으로 사용하세요. 생성 성공 여부는 data.state가 succeeded인지로 판단합니다.

준비된 output.assets[].url을 바로 내려받으세요. API 키는 보내지 않습니다. expiresAt은 보통 20분 뒤이며 결과 보관 기간인 14일을 넘지 않습니다. 만료되면 다시 조회하세요. download-url은 선택 사항입니다.

전체 필드 정의는 OpenAPI 3.1 사양을 확인하세요.