快速开始

创建 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/v1

3. 复制模型 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 密钥。

下一步