Daftar model Rivya API, pahami ID model, kategori, batas prompt, media referensi, status kesiapan, dan dependensi Files 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
coming_soon: model generasi asinkron, tetapi belum diekspos melalui Public API saat ini
studio_only: model tersedia melalui Studio atau surface 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.

Model API

Bentuk Respons

Status Ketersediaan

Kebijakan Jumlah Model

Halaman Terkait

Daftar Isi