Panggil API Flatkey secara langsung

Base URL: https://router.flatkey.ai Flatkey menyediakan REST API yang kompatibel dengan OpenAI. Jika Anda sudah memiliki HTTP client, Anda tidak memerlukan SDK. Halaman ini adalah jalur tercepat dari sebuah kunci menuju permintaan yang berfungsi.

Autentikasi

Setiap permintaan membawa kunci Anda sebagai bearer token:

Authorization: Bearer YOUR_FLATKEY_API_KEY

Buat kunci di konsol. Kunci dimulai dengan sk-fk-. Simpan dalam variabel lingkungan dan jaga agar tidak masuk ke source control atau kode browser.

export FLATKEY_API_KEY="sk-fk-..."

Kirim permintaan

curl --fail-with-body -sS https://router.flatkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

Panggilan yang berhasil mengembalikan objek chat completion standar dengan choices dan usage.

Endpoint yang tersedia

Endpoint	Tujuan
`POST /v1/chat/completions`	Generasi teks dan chat
`POST /v1/responses`	Responses API, untuk model OpenAI
`POST /v1/images/generations`	Generasi dan pengeditan gambar
`POST /v1/videos`	Generasi video, asinkron
`GET /v1/videos/{task_id}`	Polling tugas video
`GET /v1/models`	Daftar model yang tersedia
`GET /v1/credits`	Saldo yang tersisa

POST /v1/responses saat ini hanya berfungsi dengan model OpenAI. Keluarga model lain akan mengembalikan error pada endpoint ini — gunakan POST /v1/chat/completions untuk model tersebut.

Periksa saldo Anda

curl --fail-with-body -sS https://router.flatkey.ai/v1/credits \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

{ "remaining": 34.18, "used": 185.13 }

Tangani error

Error mengembalikan body JSON dengan pesan yang dapat Anda tindaki:

{ "error": { "message": "No available channel for model ..." } }

Status	Arti	Yang harus dilakukan
`400`	Permintaan tidak valid	Baca pesannya; pesan tersebut menyebutkan field yang bermasalah
`401`	Kunci tidak valid	Periksa header `Authorization` dan nilai kunci
`429`	Terlalu banyak permintaan	Tunda dan coba lagi
`500`, `503`	Model atau rute tidak tersedia	Ganti model. Mencoba ulang model yang sama jarang berhasil

Daftar lengkap ada di referensi error.

Langkah berikutnya

Referensi API

Setiap endpoint, parameter, dan field respons.

Gunakan SDK sebagai gantinya

Pertahankan client OpenAI atau Anthropic Anda dan ubah satu baris saja.

Mulai Cepat

Kode

Alat AI Populer

Pembuatan Media

Model Populer

Dasbor

Referensi

Panggil API Flatkey secara langsung

Autentikasi

Kirim permintaan

Endpoint yang tersedia

Periksa saldo Anda

Tangani error

Langkah berikutnya

Referensi API

Gunakan SDK sebagai gantinya

​Autentikasi

​Kirim permintaan

​Endpoint yang tersedia

​Periksa saldo Anda

​Tangani error

​Langkah berikutnya

Referensi API

Gunakan SDK sebagai gantinya

Autentikasi

Kirim permintaan

Endpoint yang tersedia

Periksa saldo Anda

Tangani error

Langkah berikutnya