01
영상 API 솔루션
프롬프트나 정지 컷 한 장을 완성된 영상으로.
길이·해상도·오디오·가격으로 영상 엔드포인트를 비교한 뒤, 같은 요청을 서버에서 보내고 작업 ID로 추적하세요.
가이드 읽기 →SpicyAPI로 구축하기
페이지들이 어떻게 이어지나
모델 고르기에서 운영 트래픽까지
- 01필요한 결과물(이미지·편집·영상·텍스트)을 정하고, 해당 페이지에서 그 작업의 필드·상한·가격 다이얼을 읽으세요.
- 02모델 페이지에서 요청을 조립해 견적을 내고, 금액·콘텐츠 경계·그 엔드포인트의 이용 가능 여부를 확인하세요.
- 03백엔드에서 멱등 키와 함께 보내고, 서명된 콜백으로 마무리한 뒤 결과를 자체 스토리지로 복사하세요.
- 04키별 소비 상한을 설정하고 아홉 개 오류 코드를 제품 상태에 매핑한 다음에야 실제 트래픽 비중을 올리세요.
아래 모든 페이지의 공통 전제
하나의 봉투, 하나의 상태 기계, 하나의 통화
모든 /api/v1 응답은 {code, msg, data, request_id}라는 같은 봉투로 돌아오고, 모든 미디어 작업은 queued · running · succeeded · failed · expired라는 같은 다섯 상태를 지납니다. 실패는 content_rejected를 포함한 아홉 개의 안정된 errorCode 값 중 하나를 싣고, 그 밖의 값은 upstream_failed로 처리하면 됩니다. 가격은 공개된 과금 단위로 표시되며 중간에 크레딧은 없습니다.
| 계약 | 값 |
|---|---|
| response envelope | {code, msg, data, request_id} |
| media task state | queued · running · succeeded · failed · expired |
| errorCode | 9 stable values · closed set |
| pricing | Per published unit · no credits |
| availability | 99.9% target, our own layer · not an SLA · excludes model providers · status.spicyapi.ai |
좌우로 밀어 모든 항목을 확인하세요.
만들 수 있는 기능
결과물 종류마다 한 페이지. 가격을 움직이는 필드와 결과를 재현 가능하게 만드는 필드를 짚어 줍니다.
연동 가이드
그 아래의 동작 원리. 참조 이미지를 들여보내는 법, 요청이 사라진 뒤 작업을 끝내는 법, SDK가 이미 아는 프로토콜을 쓰는 법.
01
연동 가이드
이미 마음에 드는 정지 컷을 움직이세요.
참조 이미지를 짧은 영상으로. 첫 프레임 품질, 비율 불일치, 모션 필드, 길이가 결과와 가격에 미치는 영향.
가이드 읽기 →02
구현 가이드
요청이 사라진 뒤에 작업을 끝내세요.
오래 걸리는 미디어 작업을 서버에서 보내고 확실히 끝내기. 멱등 키, 서명된 콜백, 상한을 둔 폴링, 다섯 상태의 상태 기계.
가이드 읽기 →03
연동 가이드
클라이언트는 그대로, Base URL과 model 값만 바꾸세요.
기존 OpenAI·Anthropic·Google 클라이언트를 그대로 가리키세요. 무엇이 그대로 통하고, 무엇이 일부러 거부되며, 텍스트는 어떻게 과금되는지.
가이드 읽기 →다른 곳에서 옮겨오기
이미 다른 곳을 호출하는 팀을 위해 계약을 항목별로 비교하고, 실제로 시험한 롤백을 전제로 설계합니다.
카탈로그가 아니라 워크플로 하나를 옮기세요.
한 번에 하나의 워크플로만 옮기세요. 필드를 매핑하고, 상태와 오류를 정리하고, 청구를 비교하고, 실제로 시험한 롤백 경로와 함께 전환합니다.
가이드 읽기
모델
이 작업에 바로 호출할 수 있는 모델
각 링크는 해당 모델 계열 페이지로 이동합니다. 입력, 상한, 콘텐츠 방침, 단위당 현재 가격을 그곳에서 확인할 수 있습니다.