API Model

Endpoint GET /v1/models berfungsi untuk mengembalikan metadata model yang digunakan dalam sistem routing Lunos. Informasi tersebut mencakup ID model, vendor penyedia, modalitas, parameter yang didukung, estimasi harga, dan konfigurasi fitur kuota gratis jika tersedia. Anda dapat memanfaatkan data ini untuk membuat fitur pemilihan model yang dinamis dan memvalidasi ID model sebelum melakukan pengiriman request.

Daftar Terbuka: Pada sebagian besar konfigurasi deployment, mengakses daftar model tidak memerlukan autentikasi. Namun, jika lingkungan server Anda mewajibkan penggunaan API key, pastikan untuk menyertakan header Authorization seperti saat Anda mengakses endpoint lainnya.

Endpoint

GET /v1/models

Parameter Query (Opsional):

Parameter	Tipe	Wajib	Deskripsi
input	string	Tidak	Digunakan untuk memfilter model berdasarkan jenis input yang didukung. Gunakan koma untuk memasukkan beberapa modalitas sekaligus.
output	string	Tidak	Digunakan untuk memfilter model berdasarkan jenis output yang didukung. Gunakan koma untuk memasukkan beberapa modalitas sekaligus.

Contoh penggunaan:

# Output mendukung image generation
curl -s "https://api.lunos.tech/v1/models?output=image"

# Mendukung input text atau image, dan output text
curl -s "https://api.lunos.tech/v1/models?input=text,image&output=text"

URL Lengkap:

GET https://api.lunos.tech/v1/models

Format Response

Endpoint ini akan langsung mengembalikan array JSON berisikan daftar objek model (tanpa dibungkus di dalam key data).

[
  {
    "id": "openai/gpt-4o",
    "modelId": "openai/gpt-4o",
    "permaslug": "openai-gpt-4o",
    "name": "GPT-4o",
    "provider": "openai",
    "parameters": {
      "context": 128000,
      "max_output_tokens": 4096,
      "size": "4B"
    },
    "pricePerMillionTokens": {
      "input": 5.0,
      "output": 15.0,
      "discountPercentage": 0
    },
    "supportedParameters": ["temperature", "max_tokens"],
    "inputModalities": ["text", "image"],
    "outputModalities": ["text"],
    "description": "OpenAI multimodal flagship model.",
    "freeConfig": {
      "maxTokens": 1000,
      "isPremium": false
    },
    "isEnabled": true,
    "avgThroughput": 0,
    "supportReasoning": true,
    "maxCompletionTokens": 4096,
    "releaseDate": "2024-05-13",
    "createdAt": "2026-01-10T10:00:00.000Z",
    "updatedAt": "2026-01-10T10:00:00.000Z"
  }
]

Penjelasan Field

Field	Deskripsi
id	String ID yang wajib digunakan sebagai argumen model pada saat memanggil API Lunos.
modelId	ID model unik (kanonis) dari katalog Lunos.
name	Nama lengkap model yang mudah dibaca (human-readable).
parameters.context	Batas maksimum ukuran konteks input model (dalam jumlah token).
parameters.max_output_tokens	Batas jumlah maksimum token untuk satu proses completion (output).
provider	Slug (kode) penyedia layanan asli model tersebut (contoh: openai, google).
pricePerMillionTokens	Estimasi biaya layanan dalam satuan USD per satu juta token.
supportedParameters	Daftar parameter yang diizinkan untuk digunakan pada model tersebut (contoh: temperature, max_tokens).
inputModalities	Jenis format input yang didukung oleh model (contoh: text, image, audio).
outputModalities	Jenis format output yang dihasilkan oleh model (pada umumnya text).
freeConfig	Informasi tambahan mengenai kebijakan kuota token gratis harian (jika ada).
isEnabled	Bernilai true jika model tersebut aktif dan tersedia secara publik.
supportReasoning	Bernilai true jika model mendukung fitur reasoning (berpikir secara logis).
maxCompletionTokens	Informasi pendukung mengenai batasan completion dari katalog sistem.

Contoh Request

curl -s https://api.lunos.tech/v1/models

Contoh Response (Dipotong)

[
  {
    "id": "openai/gpt-4o",
    "modelId": "openai/gpt-4o",
    "name": "GPT-4o",
    "provider": "openai",
    "supportedParameters": ["temperature", "max_tokens"],
    "inputModalities": ["text", "image"],
    "outputModalities": ["text"]
  },
  {
    "id": "openai/text-embedding-3-small",
    "modelId": "openai/text-embedding-3-small",
    "name": "Text Embedding 3 Small",
    "provider": "openai",
    "supportedParameters": ["input"],
    "inputModalities": ["text"],
    "outputModalities": ["embedding"]
  }
]

Tips Penggunaan

• Pastikan untuk menggunakan id secara presisi sebagaimana yang tertera di response — perhatikan huruf besar/kecil dan prefix-nya.
• Lakukan pengecekan pada inputModalities dan outputModalities sebelum mengirim request berupa format text, image, audio, ataupun embedding.
• Periksa supportedParameters terlebih dahulu sebelum Anda memutuskan untuk menyertakan parameter tuning tambahan.
• Gunakan informasi pricePerMillionTokens apabila Anda ingin membuat fitur routing cerdas berdasarkan perbandingan biaya model.
• Harga yang ditampilkan bersifat estimasi (indikatif); penagihan yang sebenarnya akan didasarkan pada tarif resmi workspace Anda ketika request tersebut dijalankan.

Untuk menjelajahi daftar selengkapnya secara interaktif, silakan buka menu Daftar Model di dashboard Lunos Anda.