Langsung ke konten utama
Kazzle AI API memberi Anda satu endpoint terautentikasi untuk memanggil model apa pun yang kami dukung. Anda membayar sekali, dalam kredit, terhadap ruang Anda — tanpa akun terpisah untuk OpenAI, Anthropic, Cloudflare Workers AI, atau siapa pun yang kami arahkan. Semua endpoint berada di bawah /ai/* pada https://api.kazzle.app dan menerima kunci API kzl_ di header Authorization. Lihat Kunci API untuk cara membuat satu. Aplikasi Kazzle yang dihasilkan juga harus menggunakan API ini. Buat kunci API Kazzle untuk aplikasi, simpan di vault, sambungkan sebagai KAZZLE_API_KEY pada komponen proses, dan panggil https://api.kazzle.app/ai/* dari kode sisi server itu. Jangan minta pengguna untuk kunci penyedia kecuali mereka secara eksplisit ingin menggunakan akun penyedia mereka sendiri.

​
Kemampuan

EndpointModalitasInput StandarOutput Standar
POST /ai/chat/completionsChat (teks, streaming)messages[] kompatibel OpenAIchoices[] kompatibel OpenAI atau aliran SSE
POST /ai/responsesResponses APIKompatibel OpenAI ResponsesKompatibel OpenAI Responses
POST /ai/images/generationsGambar{ model, prompt, size?, output_format? }{ images: [{ url? | b64?, mimeType }] }
POST /ai/audio/speechText-to-speech{ model, text, voice?, format? }aliran byte audio/*
POST /ai/audio/transcriptionsSpeech-to-textmultipart/form-data dengan file + model{ text }
POST /ai/video/generationsVideo (async){ model, prompt, ... }{ id, status, pollUrl }
GET /ai/responses/{id}Poll asyncid responshasil berbentuk penyedia
POST /ai/gatewayPassthrough mentahPayload Workers AI / penyedia-native apa punRespons upstream mentah
GET /ai/modelsKatalog—{ models: [{ id, modality, pricing, ... }] }
GET /ai/models adalah sumber kebenaran untuk id model mana yang bekerja di endpoint mana. Bacalah terlebih dahulu jika Anda membangun terhadap API.

​
Cara panggilan bekerja

Setiap panggilan yang dapat ditagih melalui lima fase. Anda tidak melihat sebagian besar — mereka dilacak sisi server sehingga kami dapat mengembalikan panggilan yang gagal dan melaporkan penggunaan yang tepat.
FaseApa yang terjadi
openKami telah membuat acara penagihan yang terikat pada permintaan Anda, tetapi belum memanggil upstream.
recordedPenyedia upstream mengembalikan. Kami memiliki id log dari Cloudflare AI Gateway. Biayanya belum diketahui.
pricedCloudflare melaporkan biaya akhir. Kami menerapkan markup kami dan menulis tagihan kredit. Terminal.
failedPanggilan upstream gagal, atau kami tidak bisa mendapatkan biaya setelah 20 percobaan ulang. Pelanggan tidak ditagih. Terminal.
syncedAcara priced telah dikirimkan ke sistem metering kami.
Setiap respons yang berhasil mencakup x-kazzle-ai-billing-event-id: airesp_... — simpan jika Anda ingin menghubungkan permintaan dengan ekspor penggunaan nanti.

​
Penagihan & markup

Kami menagih cloudflare_cost_usd × (1 + markup). Markup dipublikasikan di Settings → Billing → Pricing. Panggilan yang Cloudflare hargai pada $0 (tingkat Workers AI gratis, promosi) mencapai fase priced dengan biaya nol dan tidak pernah ditagih. Cadangan: Anda memerlukan setidaknya $0,50 setara dalam kredit untuk melakukan panggilan. Kami menahan ini terhadap saldo Anda sampai panggilan selesai, kemudian menyelesaikan biaya sebenarnya.

​
Kesalahan

StatusArti
401Kunci API kzl_ hilang atau tidak valid.
402Kredit tidak cukup untuk cadangan. Isi ulang di Settings → Billing.
4xx dari upstreamDiteruskan apa adanya. Badan berisi kesalahan penyedia. Pelanggan tidak ditagih.
5xx dari upstreamDiteruskan apa adanya. Pelanggan tidak ditagih.

​
Contoh — pembuatan gambar

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" }
  ]
}

​
Contoh — text to speech

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

​
Lihat juga

  • API Reference — skema permintaan/respons lengkap untuk setiap endpoint
  • Kunci API — membuat dan menggunakan kunci kzl_
  • Penagihan — kredit, paket, dan markup yang kami terapkan