OpenAPI와 엔드포인트 목록
OpenAPI 3.1 사양, 운영 origin, 공개 엔드포인트 목록.
복사 가능한 참조 클라이언트
모델 검색, 작업 생성, 실패한 작업 재시도, 상태 조회, 모든 종료 상태, 제한된 대기, 멱등성과 오류 처리를 포함한 무의존성 예제입니다. 수락된 작업은 취소할 수 없습니다.
문서 예제이며 출시된 npm/PyPI 패키지가 아닙니다. 10분은 로컬 대기 한도이지 운영 SLA가 아닙니다.
공개 API 사양은 다운로드 가능한 OpenAPI 3.1 YAML입니다. 운영 origin은 https://api.spicyapi.ai이며 작업 API는 /api/v1, 호환 프로토콜은 /v1(Gemini 형식은 /v1beta) 아래에 있습니다.
| Method | Path |
|---|---|
POST | /api/v1/jobs/quote |
POST | /api/v1/jobs/stream |
GET | /v1/models |
POST | /v1/chat/completions |
POST | /v1/responses |
POST | /v1/messages |
POST | /v1beta/models/{model}:generateContent |
POST | /v1beta/models/{model}:streamGenerateContent |
POST | /v1/videos |
GET | /v1/videos/{videoId} |
GET | /v1/videos/{videoId}/content |
POST | /api/v1/jobs/createTask |
GET | /api/v1/jobs |
GET | /api/v1/jobs/recordInfo |
POST | /api/v1/jobs/retry |
GET | /api/v1/models |
GET | /api/v1/models/{model} |
GET | /api/v1/chat/credit |
GET | /api/v1/usage |
POST | /api/v1/common/upload-url |
POST | /api/v1/files/{fileId}/commit |
POST | /api/v1/common/download-url |
API·SDK·도구에서 기록 조회
GET /api/v1/jobs, SDK의 client.listTasks, CLI의 spicyapi tasks list, MCP의 spicyapi_tasks_list는 모두 현재 API 키로 범위가 제한된 읽기 전용 기록 조회입니다. 결과 본문은 포함하지 않으므로 선택한 taskId를 recordInfo로 조회하세요.
API 사양 활용
OpenAPI를 SDK 생성, 계약 테스트, 타입 생성에 사용하세요. 모델별 파라미터는 /models/{model}의 inputSchema를 읽고, 알 수 없는 응답 필드는 허용하되 알 수 없는 요청 필드를 추측하지 마세요.
전체 필드 정의는 OpenAPI 3.1 사양을 확인하세요.