Documentation
接入文档
接口与 OpenAI 完全兼容,只需替换 Base URL 与密钥。
Base URL
所有请求都发往下面这个地址,路径与 OpenAI 一致:
https://api.modiverse.cn/v1
鉴权
在控制台创建 API Key,放进请求头:
Authorization: Bearer sk-你的密钥
密钥只在创建时显示一次,请自行保存。泄露后立即在控制台删除重建。
模型名
模型名必须按下表原样填写(含 / 与 :free 后缀):
deepseek/deepseek-chat— 通用对话qwen/qwen-2.5-72b-instruct— 长文本meta-llama/llama-3.3-70b-instruct— 通用对话openrouter/auto— 由上游自动路由z-ai/glm-4.6v— 视觉(识图)qwen/qwen2.5-vl-72b-instruct— 视觉(识图)google/gemma-4-31b-it:free— 免费google/gemma-4-26b-a4b-it:free— 免费nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free— 免费
也可以直接请求 GET /v1/models 拿到当前可用的完整清单。
对话接口
POST https://api.modiverse.cn/v1/chat/completions { "model": "deepseek/deepseek-chat", "messages": [ { "role": "user", "content": "你好" } ] }
返回结构与 OpenAI 一致,取 choices[0].message.content。
视觉模型
图片用 image_url 传入,支持 URL 或 data:image/png;base64,…:
{
"model": "z-ai/glm-4.6v",
"messages": [{
"role": "user",
"content": [
{ "type": "text", "text": "这张图里是什么" },
{ "type": "image_url", "image_url": { "url": "https://…" } }
]
}]
}
流式输出
加 "stream": true 即可,返回 SSE。网关不走 CDN 代理,长响应不会被中途掐断。
错误码
| 状态码 | 含义 | 怎么处理 |
|---|---|---|
401 | 密钥无效或缺失 | 检查 Authorization 头 |
402 | 余额不足 | 控制台充值 |
404 | 模型名不存在 | 对照上面的模型清单 |
429 | 触发限流 | 退避重试,降低并发 |
503 | 暂无可用渠道 | 稍后重试 |
常见问题
能用官方的 SDK 吗?能。OpenAI 官方 Python / Node SDK 把 base_url 指过来即可。
支持 function calling 吗?支持,取决于所选模型自身能力。
为什么模型名带前缀?前缀表示模型来源,填错会返回 404,请对照清单。
密钥在哪里生成?登录后进控制台 → API 密钥。