快速开始

准备一个豆子 API 账号、一枚密钥，以及一个当前可用的文本模型，就可以发起第一次请求。

1. 准备账号与密钥

登录控制台，按站点实际开放的方式注册或登录。
在密钥管理中创建一枚 API Key。
检查账号余额、密钥额度和有效期，确认所选分组能访问目标模型。

不知道密钥设置怎么选，可以先阅读创建与管理密钥。

2. 选择模型

打开价格与模型页面，复制可用的完整模型 ID。把下面示例中的 YOUR_MODEL_ID 换成它；不要直接填写模型的展示名称。

3. 发起请求

以下示例在本机终端或后端运行。先替换密钥和模型占位符。

macOS / LinuxWindows PowerShell

bash

export BEANC_API_KEY="YOUR_API_KEY_HERE"

curl https://api.beanc.cn/v1/chat/completions \
  -H "Authorization: Bearer $BEANC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "你好，用一句话介绍你自己。"}]
  }'

powershell

$env:BEANC_API_KEY = "YOUR_API_KEY_HERE"
$requestBody = @{
  model = "YOUR_MODEL_ID"
  messages = @(@{ role = "user"; content = "你好，用一句话介绍你自己。" })
} | ConvertTo-Json -Depth 5

$result = Invoke-RestMethod -Uri 'https://api.beanc.cn/v1/chat/completions' `
  -Method Post `
  -Headers @{ Authorization = "Bearer $env:BEANC_API_KEY" } `
  -ContentType 'application/json; charset=utf-8' `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($requestBody))

$result.choices[0].message.content

4. 确认结果

成功时，Chat Completions 的文本回答位于 choices[0].message.content。然后到使用日志核对本次调用记录。

如果出现错误，保留状态码与已脱敏的错误信息，对照排查指南检查。密钥和模型 ID 是两项独立配置，创建密钥不会自动选定模型。

继续接入

Python SDK · Node.js SDK · 客户端通用配置

密钥放在哪里

在自己的后端或可信本机环境中使用密钥。公开网页、代码仓库和分享截图中都不应包含真实密钥。

协议参考：OpenAI API Reference · Create chat completion，请求参数与响应结构。

快速开始 ​

1. 准备账号与密钥 ​

2. 选择模型 ​

3. 发起请求 ​