一、开通前准备:必备条件
- 拥有字节跳动账号(无则需先注册,支持手机号/邮箱)
- 明确API使用场景(如智能问答、内容生成等,需符合平台规范)
- 准备开发环境(可选:Python/Node.js等,或直接用curl测试)
二、豆包API开通 step by step
1. 进入豆包开放平台
- 打开浏览器访问:豆包开放平台官网(建议用最新版Chrome/Edge)
- 点击右上角「登录」,用字节账号扫码或密码登录
2. 创建API应用
- 登录后进入「控制台」→ 左侧「应用管理」→「创建应用」
- 填写应用信息:
- 应用名称(自定义,如“我的豆包问答工具”)
- 应用描述(简要说明用途,如“基于豆包API的智能客服问答”)
- 选择服务类型(目前仅支持「豆包大模型API」)
- 提交后等待审核(合规应用通常1-5分钟秒过)
3. 获取API密钥(AK/SK)
- 应用审核通过后,进入「应用详情」页面
- 复制Access Key(AK) 和Secret Key(SK)(⚠️ SK仅显示一次,需妥善保存)
三、首次调用测试:验证API可用性
以下用Python示例演示(需先安装requests库):
import requests
import json
# 替换为你的AK/SK
AK = "your_access_key"
SK = "your_secret_key"
API_URL = "https://api.doubao.com/v1/chat/completions"
headers = {
"Content-Type": "application/json",
"X-Doubao-Access-Key": AK,
"X-Doubao-Secret-Key": SK
}
data = {
"model": "doubao-3.5", # 可选:doubao-3.5/doubao-4.0
"messages": [
{"role": "user", "content": "你好,豆包API测试"}
]
}
response = requests.post(API_URL, headers=headers, json=data)
print(json.dumps(response.json(), indent=2, ensure_ascii=False))
测试成功标志:返回包含choices和content字段的JSON,如:
{
"id": "xxx",
"object": "chat.completion",
"created": 1720000000,
"model": "doubao-3.5",
"choices": [
{"message": {"role": "assistant", "content": "你好!很高兴为你服务~"}, ...}
],
...
}
四、常见问题解答
-
API密钥丢失怎么办? 进入「应用管理」→ 对应应用 →「重置密钥」(原密钥立即失效,需更新所有调用代码)
-
调用限额是多少? 免费版初始:日调用1000次,单请求≤2048 tokens;付费版可升级额度,见「计费中心」
-
支持哪些模型? 目前开放:doubao-3.5(通用)、doubao-4.0(增强版,支持长文本)
五、进阶技巧
- 批量调用:用批量接口合并多个请求(减少网络开销)
- 参数优化:设置
temperature(0-1,控制回答随机性)、top_p(控制采样范围) - 缓存常用结果:对重复请求做缓存,降低调用次数