常见问题

认证、模型、额度、计费、体验中心和接口调用的常见问题。

常见问题

如何加入售后群?

如需售后支持,可以扫码加入售后群。进群后请说明你的账号、问题现象和相关请求时间,方便快速定位。

Oimi API 售后群二维码

API 密钥创建后还能再次查看完整内容吗?

不能。API 密钥创建成功时会完整展示一次,关闭弹窗后只会显示脱敏内容。请在创建时立即复制完整密钥,并保存到服务端环境变量中。

如果密钥已经丢失,建议禁用或删除旧密钥,然后重新创建一个新密钥。

请求应该使用哪个服务地址?

请以控制台首页「API 访问」区域展示的服务地址为准。OpenAI SDK 通常填写到 /v1

https://api.oimi.xin/v1

为什么返回 API 密钥无效?

请检查:

  • Header 是否为 Authorization: Bearer $API_KEY
  • 密钥是否复制完整
  • 密钥是否已被禁用或删除
  • 当前请求是否用了错误的服务地址
  • Claude/Gemini 接口是否使用了对应 Header

为什么提示额度不足或密钥额度已耗尽?

请分别检查账户余额和 API 密钥额度。

账户余额可以在「费用」查看;API 密钥额度可以在「API 密钥」中查看和调整。若密钥设置了独立额度,额度用完后即使账户还有余额,请求也可能被拒绝。

为什么模型列表里看不到某个模型?

请先以「模型」页面为准,确认当前账号是否能看到该模型。模型可见性可能受到账号权限、模型变体和当前服务配置影响。

如果接口中使用了控制台没有展示的模型 ID,请换成「模型」页面中的实际模型 ID 后再试。

什么是模型变体?

模型变体是控制台中用于区分模型访问方式的选项。你可以在「模型」页面看到模型对应的模型变体,也可以在「API 密钥」中为密钥切换可用的模型变体。

实际可调用模型以当前 API 密钥和「模型」页面展示为准。

体验中心为什么要求选择 API 密钥?

体验中心会使用你选择的 API 密钥发起真实请求,这样可以验证密钥是否可用、模型是否可调用、额度是否充足。请求产生的用量会进入当前账号的「用量」记录。

支持流式输出吗?

支持。OpenAI 兼容 Chat Completions 可以传入:

{ "stream": true }

Gemini 也提供 streamGenerateContent 形态。具体是否可用取决于所选模型和当前服务配置。

支持 OpenAI SDK 吗?

支持 OpenAI 兼容接口。将 SDK 的 baseURL 改为平台 /v1 地址,并使用平台 API 密钥即可。模型 ID 请使用控制台「模型」页面展示的 ID。

支持 Claude 和 Gemini 原生协议吗?

支持。Claude 使用 /v1/messages,Gemini 使用 /v1beta/models/{model}:generateContent。认证 Header 分别为 x-api-keyx-goog-api-key

Gemini 也可以使用 ?key=$API_KEY 作为查询参数。实际可调用模型请以「模型」页面为准。

如何查看一次请求的费用和日志?

进入「用量」页面,可以按时间、模型、API 密钥、分组、请求 ID、上游请求 ID 过滤记录。展开记录后可以查看计费明细、模型、密钥、耗时和相关请求信息。

为什么会返回模型不可用或没有可用渠道?

常见原因包括模型 ID 写错、当前账号不可见该模型、API 密钥使用的模型变体不匹配,或上游服务临时不可用。

请先在「模型」页面复制模型 ID,再用同一个 API 密钥在「体验中心」发起测试。如果体验中心也失败,可以在「用量」中查看对应请求记录。