OpenAPI und Endpunktübersicht
OpenAPI-3.1-Vertrag, Produktions-origin und öffentliche Endpunkte.
Kopierbare Referenz-Clients
Abhängigkeitsfreie Beispiele für Modellsuche, Task-Erstellung, Wiederholung fehlgeschlagener Tasks, Statusabfragen, alle Endzustände, begrenztes Warten, Idempotenz und Fehler. Angenommene Tasks können nicht abgebrochen werden.
Dokumentationsbeispiele, keine veröffentlichten npm/PyPI-Pakete. Zehn Minuten sind ein lokales Limit, kein Produktions-SLA.
Der öffentliche Vertrag ist als OpenAPI-3.1-YAML verfügbar. Der Produktions-origin lautet https://api.spicyapi.ai; Task-APIs liegen unter /api/v1, kompatible Protokolle unter /v1 (das Gemini-Format unter /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 |
Verlauf über API, SDK und Werkzeuge
GET /api/v1/jobs, client.listTasks im SDK, spicyapi tasks list in der CLI und spicyapi_tasks_list im MCP bieten denselben schreibgeschützten Verlauf für den aktuellen API-Schlüssel. Die Ergebnisdaten fehlen bewusst in der Liste; fragen Sie den ausgewählten taskId über recordInfo ab.
Vertrag einsetzen
Nutzen Sie OpenAPI für SDK-Generierung, Vertragstests und Typen. Modellparameter kommen aus inputSchema von /models/{model}. Akzeptieren Sie unbekannte Antwortfelder, aber raten Sie keine unbekannten Request-Felder.
Die vollständigen Felddefinitionen stehen im OpenAPI-3.1-Vertrag.