OpenAPI y lista de endpoints
Contrato OpenAPI 3.1, URL base de producción y endpoints públicos.
Clientes de referencia copiables
Ejemplos sin dependencias para descubrir modelos, crear tareas, reintentar tareas fallidas, consultar todos los estados terminales, limitar la espera y tratar la idempotencia y los errores. Una tarea aceptada no se puede cancelar.
Son ejemplos de documentación, no paquetes npm/PyPI publicados. Diez minutos es un límite local, no un SLA.
El contrato público está disponible como YAML OpenAPI 3.1. La URL base de producción es https://api.spicyapi.ai y las API de tareas usan /api/v1 y los protocolos compatibles /v1 (/v1beta para el formato 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 |
Consultar el historial con API, SDK y herramientas
GET /api/v1/jobs, client.listTasks del SDK, spicyapi tasks list de la CLI y spicyapi_tasks_list de MCP ofrecen el mismo historial de solo lectura, limitado a la clave API actual. La lista no incluye los resultados; consulta el taskId elegido mediante recordInfo.
Usar el contrato
Usa OpenAPI para generar SDK, pruebas de contrato y tipos. Lee los parámetros del modelo en inputSchema de /models/{model}. Tolera campos de respuesta desconocidos, pero no inventes campos de solicitud.
Consulta el contrato OpenAPI 3.1 para ver la definición completa de los campos.