查询 Rivya API 模型，理解模型 ID、分类、提示词上限、参考素材、可用状态和 Files API 依赖。

使用 GET /api/v1/models 查询 Rivya 模型及其 Public API readiness 状态。

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

异步生成模型调用 POST /api/v1/generations 时，先检查 api_input_status，再把 id 作为 model 值。Chat 模型请调用 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 或数值类参数当前可以直接测试
partial_requires_files：部分模式不需要上传即可调用；参考素材模式应使用 Files API
requires_files_api：模型依赖通过 /api/v1/files 上传的参考素材

调用需要上传图片、视频或音频参考素材的模式前，请先使用 Files API。

对 Chat 模型，chat_capabilities 会说明 Chat API 是否支持非 streaming response、streaming response、web search、图片 file_id 附件、thoughts 和 reasoning effort。

模型数量策略

Rivya 新增、移除或灰度模型时，公开模型列表会变化。

不要在集成里写死模型数量。请读取 /api/v1/models 或动态模型 API Reference。

API 模型列表

响应结构

可用状态

模型数量策略

相关页面

目录