API 接入:从地址到第一次请求
无需登录即可阅读。模汇云提供按量付费的 OpenAI 兼容 API;账户、模型权限和可用余额确认后再发起请求。
接入前准备
- 确认账户权限、可用余额和当前报价(见价格说明页)。不要把个人聊天产品的额度与 API 余额混淆。
- 创建并妥善保管 API Key。仅放在本机环境变量或服务端,不写进网页、截图或公开仓库。
- 从账户可用模型中复制完整模型 ID,替换示例中的
YOUR_MODEL_ID。示例不是可直接使用的模型名。
Base URL 与鉴权
- OpenAI SDK 的 base_url
https://api.whenitreset.com/v1- 完整聊天请求地址
https://api.whenitreset.com/v1/chat/completions- 请求头
Authorization: Bearer 您的_API_Key
不同客户端对地址的要求不同。若客户端会自动拼接 /v1,不要重复添加;若要求完整端点,使用上面的完整聊天地址。
cURL 最小示例
先在本机安全设置 MOHUIYUN_API_KEY 环境变量,再替换模型 ID。本页不会自动执行示例或产生调用费用。
curl https://api.whenitreset.com/v1/chat/completions \
-H "Authorization: Bearer $MOHUIYUN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'Python SDK 示例
使用 OpenAI Python SDK,并在本机设置 MOHUIYUN_MODEL。示例关闭自动重试,方便排查首次请求。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MOHUIYUN_API_KEY"],
base_url="https://api.whenitreset.com/v1",
max_retries=0,
)
response = client.chat.completions.create(
model=os.environ["MOHUIYUN_MODEL"],
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)请求后检查
确认返回状态、响应内容和控制台用量。请求超时不等于没有发生处理,避免盲目重复提交;计费与异常请按实际账单和错误信息核对。