快速开始
创建 API 密钥,复制模型 ID,并完成第一次 Oimi API 调用。
欢迎使用 Oimi API 开放平台
Oimi API 为开发者提供统一的模型调用入口。你可以在控制台创建 API 密钥,查看可用模型和价格,并通过 OpenAI 兼容接口发起请求。
如果你的应用已经使用 OpenAI SDK,通常只需要替换服务地址、API 密钥和模型 ID。Claude Messages 与 Gemini generateContent 也提供对应的协议入口,实际可调用模型以控制台「模型」页面为准。
你可以用它做什么
- 创建和管理 API 密钥
- 使用 OpenAI 兼容 SDK 调用可用模型
- 在「模型」查看模型 ID、价格、倍率和模型变体
- 在「体验中心」测试模型效果
- 在「用量」按时间、模型、API 密钥或请求 ID 查看调用记录
- 在「费用」查看账户余额、充值入口和账单记录
- 启用、禁用、删除 API 密钥,或调整密钥额度和模型变体
第一次调用
1. 创建 API 密钥
登录控制台后,进入「API 密钥」页面,点击「创建 API 密钥」。创建时填写一个便于识别用途的备注,例如 生产环境应用。
新创建的密钥只会完整展示一次。关闭弹窗后,控制台只会显示脱敏后的密钥,请在创建时立即复制并保存到服务端环境变量中。
2. 查看服务地址
在控制台首页的「API 访问」区域查看当前服务地址。示例中使用 https://api.oimi.xin,实际接入时请以控制台展示的服务地址为准。
SDK 接入时通常填写到 /v1:
https://api.oimi.xin/v13. 复制模型 ID
进入「模型」页面,复制你要调用的模型 ID。模型列表会展示当前账号可用的模型、价格和模型变体。
4. 发送请求
curl https://api.oimi.xin/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "model-id",
"messages": [
{ "role": "user", "content": "你好,介绍一下你自己" }
],
"stream": true
}'将 model-id 替换为「模型」页面中的实际模型 ID,将 $API_KEY 替换为你创建的 API 密钥。