OpenAPI et liste des points de terminaison
Contrat OpenAPI 3.1, origin de production et points de terminaison publics.
Clients de référence copiables
Exemples sans dépendance couvrant la découverte des modèles, la création de tâches, la relance d’une tâche en échec, le suivi des états, l’attente bornée, l’idempotence et les erreurs. Une tâche acceptée ne peut plus être annulée.
Ce sont des exemples de documentation, pas des paquets npm/PyPI publiés. Dix minutes est une limite locale, pas un SLA.
Le contrat public est un fichier OpenAPI 3.1 YAML téléchargeable. L’origin de production est https://api.spicyapi.ai et les API de tâches utilisent /api/v1 et les protocoles compatibles /v1 (/v1beta pour le format Gemini).
| 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 |
Consulter l’historique par API, SDK ou outil
GET /api/v1/jobs, client.listTasks dans le SDK, spicyapi tasks list dans la CLI et spicyapi_tasks_list dans MCP donnent accès au même historique en lecture seule, limité à la clé API actuelle. La liste ne contient pas les résultats : consultez le taskId choisi avec recordInfo.
Exploiter le contrat
Utilisez OpenAPI pour générer SDK, tests de contrat et types. Lisez les paramètres de modèle dans inputSchema de /models/{model}. Tolérez les champs de réponse inconnus, mais n’inventez aucun champ de requête.
Consultez le contrat OpenAPI 3.1 pour la définition complète des champs.