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 密钥。