Contrato Spicy Schema
Solicitação comum, campos canônicos, schema de formulário, estados assíncronos, erros, armazenamento de resultados e compatibilidade.
Spicy Schema é o contrato público comum dos novos modelos de mídia. Autenticação, tarefas assíncronas, erros, resultados e downloads permanecem estáveis quando o modelo muda.
{
"model": "MODEL_ID_FROM_CATALOG",
"input": {
"prompt": "slow camera push-in",
"duration_seconds": 8
},
"callBackUrl": "https://your-app.example.com/hooks/spicy"
}Campos canônicos e Schema
Novos endpoints usam nomes snake_case comuns como prompt, image_url, last_image_url, duration_seconds, resolution e generate_audio. Valide a entrada com inputSchema do catálogo autenticado actual.
inputSchema segue JSON Schema 2020-12. x-ui contém apenas dicas de apresentação para o Playground, nunca regras de validação; ignore chaves x-ui desconhecidas.
Identificadores públicos e resultados
provider identifica apenas o criador do modelo. O processamento interno não é exposto na API pública. O resultado é transferido ao armazenamento da SpicyAPI e retornado com output.assets[].url assinada e metadados.
Compatibilidade
Adicionar campo opcional ou campo de resposta ignorável é compatível. Alterar campo obrigatório, tipo, sentido, enum ou limite exige nova versão do modelo ou janela de descontinuação anunciada.
Consulte o contrato OpenAPI 3.1 para ver a definição completa dos campos.