OpenAPI e lista de endpoints
Contrato OpenAPI 3.1, URL base de produção e endpoints públicos.
Clientes de referência copiáveis
Exemplos sem dependências para descobrir modelos, criar tarefas, repetir tarefas com falha, consultar todos os estados finais, limitar a espera e tratar idempotência e erros. Uma tarefa aceita não pode ser cancelada.
São exemplos da documentação, não pacotes npm/PyPI publicados. Dez minutos é um limite local, não um SLA.
O contrato público é um YAML OpenAPI 3.1 para download. A URL base de produção é https://api.spicyapi.ai e as APIs de tarefas usam /api/v1 e os protocolos compatíveis /v1 (/v1beta para o 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 o histórico pela API, SDK e ferramentas
GET /api/v1/jobs, client.listTasks no SDK, spicyapi tasks list na CLI e spicyapi_tasks_list no MCP oferecem o mesmo histórico somente leitura, limitado à chave de API atual. A lista não inclui os resultados; consulte o taskId escolhido por recordInfo.
Use o contrato
Use OpenAPI para gerar SDK, testes de contrato e tipos. Leia parâmetros de modelo no inputSchema de /models/{model}. Tolere campos de resposta desconhecidos, mas não invente campos de solicitação.
Consulte o contrato OpenAPI 3.1 para ver a definição completa dos campos.