Memulai
ID model dan varian
ID model memakai format provider/model, termasuk varian :free, :online, :nitro, dan :floor, serta fallback model dan allowlist.
ID model di api14 memakai bentuk provider/model, misalnya openai/gpt-5-mini. Kirim ID tersebut pada field model di request apa pun.
{ "model": "anthropic/claude-sonnet-4.5" }
Mencari ID model
- Jelajahi halaman model, setiap model beserta ID, harga, panjang konteks, dan kemampuannya.
- Panggil
GET /modelsdari kode; filter berdasarkan kategori dengan?category=image. Lihat Model.
Beberapa contoh:
| Kategori | Contoh ID |
|---|---|
| Teks | openai/gpt-5-mini, anthropic/claude-sonnet-4.5, google/gemini-2.5-pro, deepseek/deepseek-chat |
| Gambar | openai/gpt-5.4-image-2, google/gemini-2.5-flash-image |
| Video | google/veo-3.1-fast, openai/sora-2-pro |
| Suara (TTS) | openai/gpt-4o-mini-tts |
| Transkripsi | openai/whisper-1, openai/gpt-4o-transcribe |
| Embeddings | openai/text-embedding-3-small |
| Rerank | cohere/rerank-v3.5 |
ID bersifat peka huruf besar/kecil. ID yang tidak dikenal atau dinonaktifkan mengembalikan 404 model_not_found.
Varian
Varian adalah akhiran setelah titik dua yang mengubah cara request dilayani. Varian bekerja dengan model dasar yang sama; aturan ketersediaan dan allowlist model dasar tetap berlaku.
| Akhiran | Efek |
|---|---|
:free | Endpoint gratis dari sebuah model, jika ada. Endpoint gratis memiliki batas laju upstream yang lebih ketat. |
:online | Menambahkan hasil web search ke prompt. Lihat Web search. |
:nitro | Mengarahkan ke provider tercepat (throughput tertinggi). |
:floor | Mengarahkan ke provider termurah. |
{ "model": "openai/gpt-5-mini:online" }
:nitro dan :floor adalah pintasan untuk pengurutan provider, sama seperti provider: { sort: "throughput" } dan provider: { sort: "price" }. Lihat Provider routing dan fallback.
Fallback model
Kirim array models untuk mencoba model lain saat model pertama gagal atau tidak tersedia:
{
"model": "anthropic/claude-sonnet-4.5",
"models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
"messages": [{ "role": "user", "content": "Hello" }]
}
Setiap model dalam daftar harus tersedia dan diizinkan untuk key dan paket Anda, jika tidak request ditolak sebelum dikirim. Field model pada respons memberi tahu model mana yang menjawab, dan Anda membayar harga model tersebut.
Allowlist dan paket
- Key dengan allowlist model hanya dapat memakai ID yang terdaftar; ID lain mengembalikan
403 model_not_allowed. - Semua paket, termasuk Free, mencakup semua kategori model, termasuk video dan musik/audio. Paket yang dibatasi ke kategori tertentu mengembalikan
403 plan_requireduntuk kategori lainnya. Lihat Harga dan penagihan.
Perubahan model
Katalog diperbarui secara otomatis. Model baru muncul dengan sendirinya; model yang dihapus mengembalikan 404 model_not_found. Kunci ID yang persis di production dan gunakan fallback models untuk ketahanan.