본문으로 건너뛰기

연동

하나의 일관된 API로 이미지·비디오와 일부 언어 모델을 연동하세요.

채팅과 역할극에는 OpenAI 호환 API를, 이미지·동영상·오디오에는 작업 API를 사용하세요. 모델을 고르고 키를 서버에 보관한 뒤 원하는 결과에 맞는 연동 경로를 따라가면 됩니다.

연결 방법 고르기

API 키 하나, 연결 방법은 네 가지

지금 일하는 곳에서 시작하세요. 어떤 방법으로 연결해도 같은 모델을 같은 가격에 쓸 수 있습니다.

5분 만에 시작하기

4단계로 첫 이미지 만들기

작업을 만들고, 작업 ID를 보관한 뒤, 완성된 파일을 받으면 됩니다. 이미지·영상·오디오 모델 모두 같은 흐름입니다.

  1. 01

    모델 선택

    작업 적합성, 입력, 정책, 현재 상태와 가격을 비교합니다.

  2. 02

    실행 요청 복사

    예제의 모델 ID와 input을 해당 모델 페이지에 표시된 정확한 필드로 바꿔 주세요. 다른 모델을 보고 파라미터를 짐작하면 안 됩니다.

  3. 03

    서버에서 제출

    HTTP 202는 작업이 접수되었음을 나타내며 생성 완료를 의미하지 않습니다. 응답 본문의 비즈니스 코드는 code: 200입니다. data.taskId를 저장하세요. estimatedCost는 해당 작업을 위해 확보한 예상 금액입니다.

  4. 04

    횟수를 제한해 상태 조회하기

    queued와 running은 실행 중이고 succeeded, failed, expired는 종료 상태입니다. 성공만 기다리지 말고 어떤 종료 상태든 만나면 조회를 멈추세요.

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: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image 모델은 실제 텍스트→이미지 엔드포인트입니다. 다른 미디어 모델로 바꿀 때는 정확한 ID와 스키마를 사용하세요.

목록

모든 연동을 한곳에서

이미 쓰고 있는 도구를 고르세요. 카드마다 설정 가이드가 열립니다.

서버 보안

프로덕션에서 반드시 처리할 세 가지

아래 세 가지는 각각 키 유출, 중복 과금, 작업 유실을 막아 줍니다. 출시 전 최소 기준입니다.

API 키는 서버에만 보관

브라우저, 모바일 번들, prompt, log 또는 agent 출력에 키를 노출하지 말고 직접 관리하는 backend에서 요청을 보내세요.

Idempotency-Key

작업을 만들 때마다 고정된 Idempotency-Key를 보내세요. 네트워크 결과가 불확실하면 같은 작업을 같은 키로 재시도해서 과금되는 작업이 두 건 생기지 않게 하세요.

수락된 미디어 작업 추적

반환된 taskId를 저장하고 서명된 webhook 또는 제한된 상태 조회를 사용합니다. 수락되면 실행이 시작되어 취소할 수 없습니다. 실패하거나 시간이 초과된 작업에는 보통 요금이 부과되지 않습니다. 단, 모델 페이지에 명시된 일부 모델은 콘텐츠 거부에도 요금을 부과합니다. 제출 전에 해당 과금 조건을 확인하세요.

API 문서

궁금한 것부터 상세 문서로