Spicy Schema 사양

공통 요청, 표준 필드, 폼 Schema, 비동기 상태, 오류, 결과 저장과 호환성 규칙.

Spicy Schema는 새 미디어 모델이 공유하는 공개 API 사양입니다. 모델이 바뀌어도 인증, 비동기 작업, 오류, 결과와 다운로드 흐름은 같습니다.

API

{
  "model": "MODEL_ID_FROM_CATALOG",
  "input": {
    "prompt": "slow camera push-in",
    "duration_seconds": 8
  },
  "callBackUrl": "https://your-app.example.com/hooks/spicy"
}

표준 필드와 Schema

새 엔드포인트는 prompt, image_url, last_image_url, duration_seconds, resolution, generate_audio 같은 공통 snake_case 이름을 사용합니다. 실행 전 인증된 라이브 카탈로그의 inputSchema로 검증하세요.

inputSchema는 JSON Schema 2020-12입니다. x-ui는 Playground 표시 힌트일 뿐 검증 규칙이 아니며, 알 수 없는 x-ui 키는 무시합니다.

공개 식별자와 결과

provider는 모델 개발사를 뜻합니다. 결과는 SpicyAPI 저장소에 보관되며 서명된 output.assets[].url과 메타데이터를 반환합니다. 공개 응답에는 이용에 필요한 정보만 포함됩니다.

호환성

선택 필드와 무시 가능한 응답 필드 추가는 호환됩니다. 필수 필드, 타입, 의미, enum 또는 제한 변경에는 새 모델 버전이나 공지된 폐기 기간이 필요합니다.

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

Spicy Schema 사양

표준 필드와 Schema

공개 식별자와 결과

호환성

관련 문서