RuiHuAI API 使用教程

第一步：获取专属密钥

登录平台后台，在「API密钥」页面创建并复制您的专属API Key。每个账户可创建多个密钥，方便区分不同项目。

登录平台后，点击页面右上角的「我的密钥」按钮，进入API密钥管理页面。您将看到四种能力类型的选项：文本对话、图片生成、视频生成和音频生成。

选择您需要的能力类型，点击「生成API Key」按钮即可创建专属密钥。每个账户支持创建多个密钥，方便您为不同项目或环境（如开发、测试、生产）分别管理。

安全注意事项

• 创建密钥后，完整Key将自动复制到剪贴板，请立即保存到安全位置。
• 切勿将密钥提交到代码仓库（如GitHub）或在公开场合分享。
• 如密钥泄露，请及时在密钥管理页面删除并重新生成新密钥。
• 建议为不同项目或环境（开发、测试、生产）分别创建独立的密钥。

第二步：配置调用代码

将以下Python代码复制到您的项目中，替换 {{your_domain}} 为平台分配的域名，替换 {{api_key}} 为您的专属密钥即可。

from openai import OpenAI

client = OpenAI(
    api_key="{{api_key}}",
    base_url="https://api.ruihu-bim.cn/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello! What can you do?"}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)
print(f"Usage: {response.usage}")

代码参数说明

• api_key：您的专属API密钥，在「我的密钥」页面创建后获取。
• base_url：平台API地址，固定为 https://api.ruihu-bim.cn/v1，无需修改。
• model：指定调用的模型名称，如 RuiHuAI（文本）、RuiHuAI-Image（图片）等。
• messages：对话消息列表，包含role（角色：system/user/assistant）和content（内容）两个字段。

其他语言调用示例

使用curl命令行调用：

curl https://api.ruihu-bim.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "RuiHuAI",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

使用JavaScript（Node.js）调用：

const response = await fetch("https://api.ruihu-bim.cn/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    model: "RuiHuAI",
    messages: [{ role: "user", content: "Hello!" }]
  })
});
const data = await response.json();
console.log(data.choices[0].message.content);

第三步：运行调用与结果查看

运行代码即可调用AI模型，所有模型永久免费，后台可实时查看调用日志。

运行代码后，您将收到JSON格式的响应结果。其中 response.choices[0].message.content 包含模型生成的文本内容，response.usage 包含本次调用的token用量统计（prompt_tokens、completion_tokens、total_tokens）。

调试与用量监控

• 登录平台后台，在密钥管理页面可查看每个API Key的剩余额度和已用额度。
• 调用日志记录了每次请求的时间、模型、token消耗等详细信息，帮助排查问题。
• 如遇调用失败，请检查密钥是否有效、API地址是否正确、以及网络连接是否正常。
• 建议在高频调用场景下做好请求队列和缓存处理，避免触发频率限制。