Model API

Gunakan GET /api/v1/models untuk mencantumkan model Rivya beserta kesiapan Public API-nya.

curl https://rivya.ai/api/v1/models

Endpoint ini publik dan read-only. Responsnya mengembalikan layer model publik yang sama dengan yang digunakan oleh dokumentasi API dan debugger online, termasuk model yang belum sepenuhnya callable.

Bentuk Respons

Respons memakai bentuk berikut:

{
  "object": "list",
  "data": [
    {
      "id": "z-image",
      "display_name": "Z-Image",
      "category": "image",
      "runtime": "async_task",
      "base_credits": 1,
      "billing_type": "FIXED",
      "supported_modes": ["text-to-image"],
      "max_prompt_length": 1000,
      "reference_media": null,
      "params": [],
      "api_status": "available",
      "api_input_status": "available_text",
      "supported_api_inputs": ["text"],
      "requires_files_api": false,
      "requires_upload_for_modes": [],
      "url_input_supported": false,
      "file_kinds": [],
      "chat_capabilities": null,
      "notices": []
    }
  ]
}

Gunakan id sebagai nilai model di POST /api/v1/generations untuk model generasi asinkron. Untuk model chat, gunakan POST /api/v1/chat/completions dan periksa chat_capabilities.

Status Ketersediaan

Referensi model memakai status publik berikut:

• available: setidaknya satu jalur generasi Public API tersedia

• temporarily_unavailable: model sementara tidak tersedia dan saat ini tidak dapat dipanggil melalui Public API v1

• studio_only: model tersedia melalui Studio atau area produk lain, bukan melalui Public API v1

Field kesiapan input lebih spesifik:

• available_text: request berbasis prompt dapat diuji langsung

• available_url_input: URL publik atau params scalar dapat diuji langsung

• partial_requires_files: beberapa mode dapat dipanggil tanpa upload; mode media referensi sebaiknya memakai Files API

• requires_files_api: model bergantung pada media referensi yang diunggah melalui /api/v1/files

Gunakan Files API sebelum memanggil mode yang membutuhkan referensi gambar, video, atau audio yang diunggah.

Untuk model chat, chat_capabilities mendokumentasikan apakah Chat API mendukung respons non-streaming, respons streaming, web search, lampiran gambar file_id, thoughts, dan reasoning effort.

Kebijakan Jumlah Model

Daftar model publik berubah saat Rivya menambah, menghapus, atau membatasi akses model.

Jangan mengandalkan jumlah model yang hard-coded dalam integrasi Anda. Selalu baca /api/v1/models atau Referensi API Model yang dinamis.

Halaman Terkait

• Referensi API Model

• Membuat Generasi

• Chat API

• Panduan Pemilihan Model Rivya

• Ketersediaan Model di Rivya

Entri Segera hadir hanya-baca

• coming_soon: model hanya ditampilkan untuk penemuan dan tidak dapat dikirim ke API generasi atau Chat. Entri mengembalikan supports_direct_generation: false, runtime, penagihan, dan harga null, serta supported_modes dan params kosong. Pilih api_status: available untuk permintaan.