常见问题

如何查看支持的模型列表

您可以通过 /v1/models 接口获取所有支持的模型：

curl https://api.modelverse.cn/v1/models \
  -H "Content-Type: application/json"

推荐使用 Cherry Studio 客户端，配置 API 地址后点击管理按钮即可直观查看所有支持的模型。详细配置教程请参考：Cherry Studio 配置教程。

GPT-5/o 系列模型参数报错

OpenAI 官方已将 max\_tokens 参数标记为废弃（deprecated），GPT-5 系列和 o 系列模型均不再支持该参数。详情请参考 OpenAI 官方文档。

如需传入图像文件，请使用 base64 编码，暂不支持 URL 方式。

gpt-5-codex 和 gpt-5.1-codex 系列模型说明

这两个系列模型仅支持 /v1/response/ 接口。

Gemini 系列模型如何开启 / 关闭思考过程

使用 Gemini 协议的 v1beta/models 接口，并配置以下参数。

详细文档请参考 Gemini 协议兼容： https://docs.ucloud.cn/modelverse/api_doc/text_api/gemini_compatible

"generationConfig": {
    "thinkingConfig": {
        "include_thoughts": true,
        "thinkingBudget": 0
    }
}

参数说明

include\_thoughts：设置为 true 开启思考过程输出，设置为 false 关闭
thinkingBudget：控制思考时间预算

Claude 系列模型说明

Claude Sonnet 4.5 仅支持指定 temperature 或 top\_p 参数中的一个，不能同时使用这两个参数。

详见官方文档说明： https://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html

Gemini 系列模型安全等级说明

Gemini API 提供了灵活的安全设置功能，允许您在原型设计和生产环境中根据应用场景调整内容过滤策略。通过配置安全等级，您可以在五个过滤器类别中精确控制内容审核的严格程度。

安全设置配置示例

以下示例展示如何关闭所有内容过滤（BLOCK\_NONE），适用于需要最大灵活性的开发场景：

{
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HATE_SPEECH",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_NONE"
    },
    {
      "category": "HARM_CATEGORY_CIVIC_INTEGRITY",
      "threshold": "BLOCK_NONE"
    }
  ]
}

可用的过滤类别

HARM\_CATEGORY\_HATE\_SPEECH：仇恨言论
HARM\_CATEGORY\_SEXUALLY\_EXPLICIT：色情内容
HARM\_CATEGORY\_DANGEROUS\_CONTENT：危险内容
HARM\_CATEGORY\_HARASSMENT：骚扰内容
HARM\_CATEGORY\_CIVIC\_INTEGRITY：公民诚信

可用的阈值选项

阈值（HarmBlockThreshold）用于控制在达到或超过指定有害概率时进行内容屏蔽：

HARM\_BLOCK\_THRESHOLD\_UNSPECIFIED：阈值未指定
BLOCK\_LOW\_AND\_ABOVE：允许 "可忽略" 风险的内容，屏蔽 "低" 及以上风险的内容
BLOCK\_MEDIUM\_AND\_ABOVE：允许 "可忽略" 和 "低" 风险的内容，屏蔽 "中" 及以上风险的内容
BLOCK\_ONLY\_HIGH：允许 "可忽略"、"低" 和 "中" 风险的内容，仅屏蔽 "高" 风险内容
BLOCK\_NONE：允许所有内容，不进行任何屏蔽
OFF：关闭安全过滤功能

根据您的应用需求和使用场景选择合适的阈值配置。建议在生产环境中使用更严格的过滤策略以确保内容安全。