Контракт Spicy Schema
Общий запрос, канонические поля, schema формы, асинхронные состояния, ошибки, хранение результатов и совместимость.
Spicy Schema — общий публичный контракт для новых медиамоделей. Аутентификация, асинхронные задачи, ошибки, результаты и загрузки не меняются при смене модели.
{
"model": "MODEL_ID_FROM_CATALOG",
"input": {
"prompt": "slow camera push-in",
"duration_seconds": 8
},
"callBackUrl": "https://your-app.example.com/hooks/spicy"
}Канонические поля и Schema
Новые эндпоинт используют общие snake_case-имена: prompt, image_url, last_image_url, duration_seconds, resolution и generate_audio. Проверяйте ввод по inputSchema из аутентифицированного live-каталога.
inputSchema соответствует JSON Schema 2020-12. x-ui содержит только подсказки отображения для Playground, а не правила проверки; неизвестные ключи x-ui игнорируются.
Публичные идентификаторы и результаты
provider обозначает разработчика модели. Используйте публичные идентификаторы и документированные коды ошибок. Результаты сохраняются в хранилище SpicyAPI и возвращаются с подписанной output.assets[].url и метаданными.
Совместимость
Добавление необязательного или игнорируемого поля ответа совместимо. Изменение обязательного поля, типа, смысла, enum или лимита требует новой версии модели либо объявленного периода вывода.
Полные определения полей приведены в контракте OpenAPI 3.1.