Referensi API
Ambil satu model
GET /v1/models/{id} mengembalikan satu model dari katalog berharga, dalam format model OpenAI.
Di halaman ini
Mengembalikan satu model dari katalog berharga berdasarkan ID-nya. Tool memanggil ini untuk memastikan sebuah model ada sebelum memakainya.
Request
Endpoint ini tidak menerima body request.
curl https://api.larasrouter.com/v1/models/deepseek-flash \
-H "Authorization: Bearer $LARAS_API_KEY"
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.larasrouter.com/v1",
api_key=os.environ["LARAS_API_KEY"],
)
print(client.models.retrieve("deepseek-flash"))
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.larasrouter.com/v1",
apiKey: process.env.LARAS_API_KEY,
});
console.log(await client.models.retrieve("deepseek-flash"));
Body respons
idstringID model yang dikirim sebagai
model, misalnyadeepseek-flash.objectstringSelalu
model.createdintegerUnix timestamp dalam detik.
owned_bystringSelalu
larasrouter.context_lengthintegerJendela konteks dalam token, dipakai bersama oleh prompt dan output.
max_output_tokensintegerNilai
max_tokens(ataumax_completion_tokens) terbesar yang diterima. Nilai yang lebih besar ditolak dengan400 max_tokens_exceeded.default_output_tokensintegerBatas output yang diterapkan jika Anda tidak mengisi
max_tokens.capabilitiesobjectFitur yang diterima gateway untuk model ini.
falseberarti request yang memakai fitur itu ditolak.streamingbooleanstream: true(Server-Sent Events).toolsbooleantools,tool_choice, danparallel_tool_calls.json_outputbooleanresponse_format: {"type": "json_object"}.thinkingbooleanReasoning dikembalikan di
reasoning_contentdan ditagih sebagai output.visionbooleanInput gambar. Selama
false, pesan dengan bagian gambar ditolak dengan400 unsupported_content.
pricingobjectHarga tetap, dalam USD per
unit_tokenstoken, sebagai string desimal yang eksak (minimal tiga angka desimal). Namanya berbeda dari field per token sepertipromptdancompletionmilik OpenRouter agar satuannya tidak tertukar.versionstringVersi harga, misalnya
deepseek-flash-2026-09-v1. Perubahan harga selalu berupa versi baru.currencystringSelalu
USD.unit_tokensintegerJumlah token yang dicakup setiap harga:
1000000.input_cache_hitstringHarga token input yang dilayani dari cache provider.
inputstringHarga token input yang tidak ada di cache (cache miss).
outputstringHarga token output, termasuk reasoning.
{
"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
| Kode | Tipe | Arti |
|---|---|---|
invalid_api_key | invalid_request_error | Kunci tidak ada, formatnya salah, sudah dicabut, atau tidak dikenal. |
| Kode | Tipe | Arti |
|---|---|---|
model_not_found | invalid_request_error | Gunakan deepseek-flash. |
| Kode | Tipe | Arti |
|---|---|---|
billing_unavailable | api_error | Coba lagi nanti. |