Spicy-Schema-Vertrag
Einheitliche Requests, kanonische Felder, Formular-Schema, asynchrone Zustände, Fehler, Ergebnisspeicherung und Kompatibilität.
Spicy Schema ist der gemeinsame öffentliche Vertrag für neue Medienmodelle. Authentifizierung, asynchrone Tasks, Fehler, Ergebnisse und Downloads bleiben bei Modellwechseln stabil.
{
"model": "MODEL_ID_FROM_CATALOG",
"input": {
"prompt": "slow camera push-in",
"duration_seconds": 8
},
"callBackUrl": "https://your-app.example.com/hooks/spicy"
}Kanonische Felder und Schema
Neue Endpunkte verwenden gemeinsame snake_case-Namen wie prompt, image_url, last_image_url, duration_seconds, resolution und generate_audio. Vor dem Aufruf validieren Sie gegen inputSchema aus dem authentifizierten Live-Katalog.
inputSchema ist JSON Schema 2020-12. x-ui enthält nur Darstellungs-Hinweise für den Playground und ist keine Validierungsregel; unbekannte x-ui-Schlüssel werden ignoriert.
Öffentliche Modellkennungen und Ergebnisse
provider bezeichnet den Modellhersteller. Verwenden Sie die veröffentlichten Modellkennungen und die dokumentierten Fehlercodes. Ergebnisse werden im Speicher von SpicyAPI abgelegt und mit einer signierten output.assets[].url sowie Metadaten zurückgegeben.
Kompatibilität
Neue optionale Felder, die bestehende Clients ignorieren können, sind rückwärtskompatibel. Änderungen an Pflichtfeldern, Typen, Bedeutung, enum oder Limits erfordern eine neue Modellversion oder eine angekündigte Übergangsfrist.
Die vollständigen Felddefinitionen stehen im OpenAPI-3.1-Vertrag.