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

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

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

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

回應 Shape

回應使用這個 shape：

{
  "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 生成路徑可用
coming_soon：非同步生成模型，但目前未透過 Public API 暴露
studio_only：模型可透過 Studio 或其他產品介面使用，不透過 Public API v1

輸入 readiness 欄位更具體：

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

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

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

模型數量政策

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

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

API 模型

回應 Shape

可用狀態

模型數量政策

相關頁面

目錄