列出 Rivya API 模型，了解模型 ID、分類、提示詞限制、參考媒體、就緒狀態與 Files API 依賴。

使用 GET /api/v1/models 列出 Rivya 模型及其 Public API 可用狀態。

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

這個端點是公開且唯讀的。它會回傳與 API 文件和線上偵錯器使用的相同公開模型清單，包含尚未完全開放呼叫的模型。

回應格式

回應使用以下格式：

{
  "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": []
    }
  ]
}

對於非同步生成模型，請使用 id 作為 model 值，並放入 POST /api/v1/generations。對於聊天模型，請使用 POST /api/v1/chat/completions 並檢查 chat_capabilities。

可用狀態

模型參考使用這些公開狀態：

available：至少有一條 Public API 生成路徑可用
temporarily_unavailable：模型暫時無法使用，目前不能透過 Public API v1 呼叫。這類唯讀項目不公開 runtime、billing、pricing、modes、params 或 Chat 能力；請在請求中選擇 available 模型。
studio_only：模型可透過 Studio 或其他產品區域使用，不透過 Public API v1

輸入就緒狀態欄位會提供更具體的資訊：

available_text：可以直接測試以提示詞為基礎的請求
available_url_input：可以直接測試公開 URL 或純量 params
partial_requires_files：部分模式可不經上傳呼叫；參考媒體模式應使用 Files API
requires_files_api：模型依賴透過 /api/v1/files 上傳的參考媒體

呼叫需要已上傳圖片、影片或音訊參考的模式前，請先使用 Files API。

對於聊天模型，chat_capabilities 會記錄 Chat API 是否支援非串流回應、串流回應、網頁搜尋、圖片 file_id 附件、thoughts 與 reasoning effort。

模型數量政策

公開模型清單會隨著 Rivya 新增、移除或限制模型而改變。

不要在整合中依賴硬編碼的模型數量。請一律讀取 /api/v1/models 或動態模型 API 參考。

即將推出的唯讀探索項目

coming_soon：模型只供探索，不能提交至生成或 Chat API。此類唯讀項目回傳 supports_direct_generation: false，runtime、billing 與 pricing 均為 null，supported_modes 與 params 為空。發送請求時請選擇 api_status: available 的模型。

API 模型

回應格式

可用狀態

模型數量政策

相關頁面

即將推出的唯讀探索項目

目錄