API v1Updated 2026-09-16

Katalog Model

GET /v1/models — daftar semua model yang terlihat lengkap dengan identifier publiknya, diurutkan untuk kemudahan penemuan.

GET /v1/models mengembalikan daftar model yang dapat Anda panggil melalui gateway. id setiap model adalah <public-name> yang Anda berikan pada field model saat request. Daftar ini diurutkan berdasarkan relevansi penemuan: model dengan peringkat lebih tinggi lebih dulu, lalu alfabetis menurut nama publik.

Endpoint#

GET/v1/models

Auth: api-key

Mendaftar semua model yang terlihat. Tanpa request body. Mengembalikan envelope object: "list" gaya OpenAI.

Responses

200Daftar model yang terlihat.

{
  "object": "list",
  "data": [
    {
      "id": "<public-name>",
      "object": "model"
    }
  ]
}

401`invalid_api_key` — key hilang, salah, atau dua header bernilai berbeda.

Bentuk respons#

Respons ini sengaja minimal: object bernilai "list", dan setiap entri di data memuat id (identifier <public-name>) serta object: "model". Field harga, supplier, dan margin tidak pernah diekspos di sini — untuk harga gunakan halaman pricing, dan untuk saldo gunakan workspace Anda.

Daftar model

curl "https://api.zrouter.dev/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Menggunakan model#

Ambil id mana pun dari respons lalu berikan sebagai model pada request chat completion, response, atau message. Identifier-nya sama di ketiga protokol.