Contrato Spicy Schema
Solicitud común, campos canónicos, esquema de formulario, estados asíncronos, errores, almacenamiento de resultados y compatibilidad.
Spicy Schema es el contrato público común de los nuevos modelos multimedia. Autenticación, tareas asíncronas, errores, resultados y descargas permanecen estables al cambiar de modelo.
{
"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 y Schema
Los endpoints nuevos usan nombres snake_case comunes como prompt, image_url, last_image_url, duration_seconds, resolution y generate_audio. Valida la entrada con inputSchema del catálogo autenticado actual.
inputSchema usa JSON Schema 2020-12. x-ui solo aporta pistas de presentación al Playground, no reglas de validación; ignora claves x-ui desconocidas.
Identificadores públicos y resultados
provider identifica únicamente al creador del modelo. El procesamiento interno no se expone en la API pública. El resultado se transfiere al almacenamiento de SpicyAPI y se devuelve con output.assets[].url firmada y metadatos.
Compatibilidad
Añadir un campo opcional o de respuesta ignorable es compatible. Cambiar un campo obligatorio, tipo, significado, enum o límite requiere una versión nueva del modelo o un periodo de retirada anunciado.
Consulta el contrato OpenAPI 3.1 para ver la definición completa de los campos.