Laras RouterDocs

Referensi API

Ambil satu model

GET /v1/models/{id} mengembalikan satu model dari katalog berharga, dalam format model OpenAI.

Di halaman ini
GEThttps://api.larasrouter.com/v1/models/{id}

Mengembalikan satu model dari katalog berharga berdasarkan ID-nya. Tool memanggil ini untuk memastikan sebuah model ada sebelum memakainya.

Autentikasi
Kirim kunci di salah satu header berikut:Authorization: Bearer lr_live_…x-api-key: lr_live_…

Request

Endpoint ini tidak menerima body request.

curl https://api.larasrouter.com/v1/models/deepseek-flash \
  -H "Authorization: Bearer $LARAS_API_KEY"

Body respons

  • idstring

    ID model yang dikirim sebagai model, misalnya deepseek-flash.

  • objectstring

    Selalu model.

  • createdinteger

    Unix timestamp dalam detik.

  • owned_bystring

    Selalu larasrouter.

  • context_lengthinteger

    Jendela konteks dalam token, dipakai bersama oleh prompt dan output.

  • max_output_tokensinteger

    Nilai max_tokens (atau max_completion_tokens) terbesar yang diterima. Nilai yang lebih besar ditolak dengan 400 max_tokens_exceeded.

  • default_output_tokensinteger

    Batas output yang diterapkan jika Anda tidak mengisi max_tokens.

  • capabilitiesobject

    Fitur yang diterima gateway untuk model ini. false berarti request yang memakai fitur itu ditolak.

    • streamingboolean

      stream: true (Server-Sent Events).

    • toolsboolean

      tools, tool_choice, dan parallel_tool_calls.

    • json_outputboolean

      response_format: {"type": "json_object"}.

    • thinkingboolean

      Reasoning dikembalikan di reasoning_content dan ditagih sebagai output.

    • visionboolean

      Input gambar. Selama false, pesan dengan bagian gambar ditolak dengan 400 unsupported_content.

  • pricingobject

    Harga tetap, dalam USD per unit_tokens token, sebagai string desimal yang eksak (minimal tiga angka desimal). Namanya berbeda dari field per token seperti prompt dan completion milik OpenRouter agar satuannya tidak tertukar.

    • versionstring

      Versi harga, misalnya deepseek-flash-2026-09-v1. Perubahan harga selalu berupa versi baru.

    • currencystring

      Selalu USD.

    • unit_tokensinteger

      Jumlah token yang dicakup setiap harga: 1000000.

    • input_cache_hitstring

      Harga token input yang dilayani dari cache provider.

    • inputstring

      Harga token input yang tidak ada di cache (cache miss).

    • outputstring

      Harga token output, termasuk reasoning.

200 OK
{
  "id": "deepseek-flash",
  "object": "model",
  "created": 1760241600,
  "owned_by": "larasrouter",
  "context_length": 1000000,
  "max_output_tokens": 384000,
  "default_output_tokens": 8192,
  "capabilities": {
    "streaming": true,
    "tools": true,
    "json_output": true,
    "thinking": true,
    "vision": false
  },
  "pricing": {
    "version": "deepseek-flash-2026-09-v1",
    "currency": "USD",
    "unit_tokens": 1000000,
    "input_cache_hit": "0.010",
    "input": "0.400",
    "output": "1.600"
  }
}

id, object, created, dan owned_by adalah field model OpenAI standar, jadi SDK OpenAI mem-parse objek ini seperti biasa. Field lainnya adalah tambahan Laras Router: batas yang ditegakkan gateway, fitur yang diterimanya, dan harga yang ditagihkan, dibaca dari katalog yang sama dengan yang menghitung tagihan request Anda.

Respons

200Model tersebut.
application/json
401Autentikasi gagal.
application/json
KodeTipeArti
invalid_api_keyinvalid_request_errorKunci tidak ada, formatnya salah, sudah dicabut, atau tidak dikenal.
404Model tidak tersedia atau tidak memiliki harga yang dipublikasikan.
application/json
KodeTipeArti
model_not_foundinvalid_request_errorGunakan deepseek-flash.
503Katalog harga sementara tidak tersedia.
application/json
KodeTipeArti
billing_unavailableapi_errorCoba lagi nanti.