Перейти до основного вмісту
Kazzle AI API надає один автентифікований endpoint для виклику будь-якої моделі, яку ми підтримуємо. Ви платите один раз кредитами за рахунок вашого простору — без окремих облікових записів для OpenAI, Anthropic, Cloudflare Workers AI чи будь-кого іншого, кому ми маршрутизуємо. Усі endpoints розташовані під /ai/* на https://api.kazzle.app і приймають ключ API kzl_ в заголовку Authorization. Див. API ключі, щоб дізнатися, як його створити. Створені додатки Kazzle також повинні використовувати цей API. Створіть ключ API Kazzle для додатка, збережіть його у сховищі, встановіть як KAZZLE_API_KEY на компоненті процесу та викличте https://api.kazzle.app/ai/* з цього серверного коду. Не просіть користувачів надавати ключі провайдера, якщо вони явно не хочуть використовувати свій облік провайдера.

​
Можливості

EndpointМодальністьСтандартизований вхідСтандартизований вихід
POST /ai/chat/completionsЧат (текст, потік)OpenAI-сумісний messages[]OpenAI-сумісний choices[] або SSE потік
POST /ai/responsesResponses APIOpenAI Responses-суміснийOpenAI Responses-сумісний
POST /ai/images/generationsЗображення{ model, prompt, size?, output_format? }{ images: [{ url? | b64?, mimeType }] }
POST /ai/audio/speechСинтез мови{ model, text, voice?, format? }audio/* потік байтів
POST /ai/audio/transcriptionsРозпізнавання мовиmultipart/form-data з file + model{ text }
POST /ai/video/generationsВідео (асинхронно){ model, prompt, ... }{ id, status, pollUrl }
GET /ai/responses/{id}Асинхронне опитуванняid відповідірезультат у форматі провайдера
POST /ai/gatewayПрямий проходБудь-який Workers AI / нативний payload провайдераСира відповідь upstream
GET /ai/modelsКаталог—{ models: [{ id, modality, pricing, ... }] }
GET /ai/models — джерело істини для того, які id моделей працюють на якому endpoint. Прочитайте його спочатку, якщо ви розробляєте для API.

​
Як працює виклик

Кожен виставлений виклик проходить п’ять фаз. Ви не бачите більшість з них — вони відстежуються на сервері, щоб ми могли повернути невдалі виклики та повідомити точне використання.
ФазаЩо сталося
openМи створили подію виставлення, пов’язану з вашим запитом, але ще не викликали upstream.
recordedUpstream провайдер повернув результат. У нас є id журналу від Cloudflare AI Gateway. Вартість ще невідома.
pricedCloudflare повідомив остаточну вартість. Ми застосували нашу надбавку та записали списання кредитів. Термінальна.
failedUpstream виклик не вдався, або ми не змогли отримати вартість після 20 повторних спроб. Клієнт не виставляється. Термінальна.
syncedПодія priced була доставлена до нашої системи вимірювання.
Кожна успішна відповідь включає x-kazzle-ai-billing-event-id: airesp_... — збережіть її, якщо хочете пізніше корелювати запит з експортом використання.

​
Виставлення та надбавка

Ми стягуємо cloudflare_cost_usd × (1 + markup). Надбавка опублікована в Параметри → Виставлення → Ціни. Виклики, які Cloudflare оцінив у $0 (безплатний рівень Workers AI, акції), досягають фази priced з нульовою вартістю та ніколи не виставляються. Резерв: вам потрібно мати принаймні $0.50 еквівалента в кредитах, щоб зробити виклик. Ми утримуємо це від вашого балансу, поки виклик не завершиться, потім розраховуємо фактичну вартість.

​
Помилки

СтатусЗначення
401Відсутній або невалідний ключ API kzl_.
402Недостатньо кредитів для резерву. Поповніть у Параметри → Виставлення.
4xx від upstreamПеренаправлено як є. Тіло містить помилку провайдера. Клієнт не виставляється.
5xx від upstreamПеренаправлено як є. Клієнт не виставляється.

​
Приклад — генерація зображення

curl https://api.kazzle.app/ai/images/generations \
  -H "Authorization: Bearer kzl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "a single red dot on white",
    "size": "1024x1024"
  }'

{
  "images": [
    { "url": "https://...", "mimeType": "image/png" }
  ]
}

​
Приклад — синтез мови

curl https://api.kazzle.app/ai/audio/speech \
  -H "Authorization: Bearer kzl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/tts-1","text":"hello world","voice":"alloy","format":"mp3"}' \
  --output speech.mp3

​
Див. також

  • API Reference — повні схеми запиту/відповіді для кожного endpoint
  • API ключі — створення та використання ключів kzl_
  • Виставлення — кредити, плани та надбавка, яку ми застосовуємо