Contrat Spicy Schema
Requête commune, champs canoniques, schéma de formulaire, états asynchrones, erreurs, stockage des résultats et compatibilité.
Spicy Schema est le contrat public commun aux nouveaux modèles multimédias. Authentification, tâches asynchrones, erreurs, résultats et téléchargements restent stables quand le modèle change.
{
"model": "MODEL_ID_FROM_CATALOG",
"input": {
"prompt": "slow camera push-in",
"duration_seconds": 8
},
"callBackUrl": "https://your-app.example.com/hooks/spicy"
}Champs canoniques et Schema
Les nouveaux point de terminaison utilisent des noms snake_case communs comme prompt, image_url, last_image_url, duration_seconds, resolution et generate_audio. Validez l’entrée avec inputSchema du catalogue live authentifié.
inputSchema suit JSON Schema 2020-12. x-ui fournit seulement des indications de présentation au Playground, jamais des règles de validation ; ignorez toute clé x-ui inconnue.
Identifiants publics et résultats
provider désigne le créateur du modèle. Utilisez les identifiants publics et les codes d’erreur documentés. Les résultats sont conservés dans le stockage SpicyAPI et renvoyés avec une output.assets[].url signée et leurs métadonnées.
Compatibilité
Ajouter un champ facultatif ou une réponse ignorable est compatible. Modifier un champ requis, un type, un sens, un enum ou une limite exige une nouvelle version de modèle ou une période d’abandon annoncée.
Consultez le contrat OpenAPI 3.1 pour la définition complète des champs.