Миграция с fal.ai

Clipia API совместим по форме с очередью fal.ai: тот же поток submit → status → result плюс вебхуки, те же поля request_id, status_url, response_url и те же значения статусов. Чтобы перейти, в большинстве случаев достаточно сменить базовый URL и ключ. Главные различия: тарификация в кредитах (не в USD), отсутствие отмены и собственная HMAC-подпись вебхуков.

Соответствие эндпоинтов и понятий

Базовый URL — https://api.clipia.ai, версия v1. Заголовок авторизации совместим со схемой Key, поэтому существующий код, использующий Authorization: Key …, продолжит работать; рекомендуемая схема для нового кода — Authorization: Bearer ….

Что меняется в коде

1. Базовый URL: queue.fal.run/{model} → https://api.clipia.ai/v1/models/{model}.
2. Ключ: $FAL_KEY → clipia_live_… (или clipia_test_… для песочницы).
3. Вебхук: вместо query-параметра ?fal_webhook= передавайте webhook_url в теле запроса.

# Было (fal.ai)
curl -X POST "https://queue.fal.run/{model}?fal_webhook=https://you/wh" \
  -H "Authorization: Key $FAL_KEY" \
  -d '{ "prompt": "..." }'

# Стало (Clipia)
curl -X POST https://api.clipia.ai/v1/models/nano-banana-2 \
  -H "Authorization: Bearer clipia_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "prompt": "..." }, "webhook_url": "https://you/wh" }'

Ключевые различия