Developer Documentation · v1

让模型接入,简单而清晰。

YUNMIVO AI 为你提供统一的 OpenAI 兼容 API。注册账号、创建密钥,即可用熟悉的调用方式接入已启用的国产模型。

三步开始使用

从控制台创建密钥后,把它放进请求头即可。

01 / ACCOUNT

注册并登录

打开控制台,完成注册或使用已有账号登录。

02 / API KEY

创建 API 密钥

进入「API Keys」,创建一枚密钥并妥善保存。

03 / REQUEST

发起第一次请求

使用下方 Base URL 与 Bearer Token 调用兼容接口。

API 接入

接口遵循 OpenAI 兼容格式,具体可用模型以控制台当前启用的渠道为准。

连接信息

Base URL

https://api.yunmivo.top/v1

认证方式

Authorization: Bearer YOUR_API_KEY

核心接口

POST /chat/completions

curl https://api.yunmivo.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role":"user","content":"你好"}]
  }'

调用建议

密钥安全

不要把 API 密钥写入前端页面、公开仓库或截图。发现泄露后请立即在控制台撤销。

模型名称

模型列表以「API Keys」页面和实际渠道配置为准,不同模型的可用性可能不同。

失败重试

遇到临时网络错误时建议指数退避重试,并为请求设置合理的超时时间。

常见问题

问题处理方式
提示未授权检查 Authorization 是否为 Bearer 密钥,并确认密钥仍有效。
找不到模型到控制台查看当前可用模型名称,按实际名称填写 model。
请求超时检查网络与请求超时设置;持续异常时联系站点客服。