Интеграция в рабочей среде
Подтверждение стоимости, восстановление запросов и хранение результатов.
Выберите модель и протокол
Читайте inputSchema и примеры из каталога с аутентификацией. enabled и available должны быть true. Публичная карточка не подтверждает доступность модели для вашего аккаунта. Нативные задачи используют /api/v1, совместимые клиенты — /v1. Cookie Console не заменяет API-ключ.
Подготовьте данные на сервере
Храните ключ в backend, не в браузере, распространяемом клиентском приложении или публичном репозитории. Соблюдайте типы, допустимые значения и условные требования текущей схемы. Для файлов получите разрешение на загрузку, выполните PUT и commit, затем передайте spicy:// URI в поле модели. При смене модели проверьте ввод заново.
Подтвердите стоимость до отправки
Передайте полный запрос с model, input и callBackUrl в jobs/quote. Покажите estimatedCost, maxCharge, currency и expiresAt. Предложение действует пять минут и не резервирует деньги. После подтверждения добавьте quoteId и expectedCost в тот же запрос. При изменении ввода или 40901 получите новую цену; не принимайте повышение автоматически. Сохраняйте суммы в виде десятичных строк.
Сохраняйте бизнес-операцию
До отправки запишите ID операции, безопасный отпечаток запроса и Idempotency-Key, затем добавьте taskId и request_id. Для того же аккаунта, API-ключа и операции используйте исходный ключ в течение 24 часов. Таймаут не доказывает отказ. Повтор окончательно неудачной задачи создаёт новую задачу на текущих условиях.
Обрабатывайте уведомления и результаты
Проверяйте подпись и время по исходным байтам, удаляйте дубликаты и сохраняйте событие. Отвечайте быстро, длительную обработку переносите в свою очередь. Учитывайте задержки и повторы по состоянию задачи. Для резервного опроса recordInfo используйте ограниченную экспоненциальную задержку. 202 означает приём, succeeded — успешную генерацию, settled=true — окончательный расчёт.
Ограничьте параллельность и хранение
Ограничьте активные задачи на аккаунт и задайте таймауты запросов. При 429 соблюдайте Retry-After, избегайте одновременного ежесекундного опроса. Каталог кешируйте кратко и только приватно. Ссылки действуют 20 минут, результаты хранятся 14 дней, загрузки — один день. Нужные файлы архивируйте. Разрыв соединения не отменяет принятую задачу.
Проверьте перед запуском
Сначала проверьте каталог, баланс и расчёты стоимости, затем минимальную генерацию с подтверждением расходов. Проверьте успех, некорректные входные данные, нехватку средств, восстановление с тем же ключом, дубли уведомлений, истёкшие ссылки и бюджет. В журнале оставляйте request_id, taskId, время, состояние и сумму, без ключей и полного промпта.
Связанные процессы
Расчёт цены и совместимость · Модели и эндпоинты · Загрузка медиа и результатов · Webhook · Ошибки и повторы · Диагностика и восстановление