豆包（Doubao）是字节跳动推出的大语言模型，通过火山引擎方舟平台（Volcano Engine Ark）提供 API 服务。豆包模型在中文理解、创作和对话方面表现出色。

注册与配置

第一步：注册火山引擎

1. 前往 火山引擎控制台 注册账号
2. 使用手机号或字节跳动账号登录
3. 完成实名认证

第二步：开通方舟平台

1. 在控制台中搜索「方舟」或「Ark」
2. 进入 方舟大模型服务平台
3. 开通服务

第三步：创建推理接入点（Endpoint）

1. 在方舟平台左侧菜单中，进入「在线推理」>「推理接入点管理」
2. 点击「创建推理接入点」
3. 选择模型（如 Doubao-pro-32k）
4. 记录生成的 Endpoint ID（如 ep-xxxxxxxxxxxxxxxx）

第四步：获取 API Key

1. 在方舟平台左侧菜单中，进入「API Key 管理」
2. 创建 API Key
3. 复制 API Key

配置 OpenClaw

豆包的 API 兼容 OpenAI 格式，可以作为自定义 OpenAI 兼容提供商接入：

// ~/.openclaw/config.json
{
  "models": {
    "providers": {
      "doubao": {
        "apiKey": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "baseUrl": "https://ark.cn-beijing.volces.com/api/v3"
      }
    }
  }
}

重要

豆包使用 Endpoint ID 作为模型标识，而非模型名称。请将 Endpoint ID 作为模型 ID 使用。

# 使用 Endpoint ID 作为模型名
openclaw models default set doubao/ep-xxxxxxxxxxxxxxxx

模型选择

在创建推理接入点时，可以选择以下模型：

模型	说明	上下文窗口
Doubao-pro-32k	旗舰版，综合能力最强	32K
Doubao-pro-128k	长文本版	128K
Doubao-pro-256k	超长文本版	256K
Doubao-lite-32k	轻量版，速度快成本低	32K
Doubao-lite-128k	轻量长文本版	128K

模型选择建议

场景	推荐模型	说明
日常对话	Doubao-pro-32k	综合能力最强
长文档处理	Doubao-pro-128k	支持长上下文
高频调用	Doubao-lite-32k	成本低，速度快
批量处理	Doubao-lite-128k	兼顾成本和上下文长度

环境变量

export DOUBAO_API_KEY="xxxxxxxxxxxxxxxxxxxxxxxx"
export DOUBAO_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"

企业特性

VPC 内网访问

火山引擎支持 VPC（Virtual Private Cloud）内网访问方舟平台，数据不经过公网。

SLA 保障

企业用户可获得 99.9% 可用性 SLA 保障。

用量管理

方舟平台提供详细的用量统计和成本分析工具。

模型微调

支持基于企业数据对豆包模型进行微调（Fine-tuning）。

价格参考

模型	输入价格（每千 Token）	输出价格（每千 Token）
Doubao-pro-32k	¥0.0008	¥0.002
Doubao-pro-128k	¥0.005	¥0.009
Doubao-lite-32k	¥0.0003	¥0.0006
Doubao-lite-128k	¥0.0008	¥0.001

说明

价格可能随时调整，请以 火山引擎官方定价 为准。

故障排查

Endpoint 不存在

• 确认 Endpoint ID 正确（格式为 ep- 开头）
• 检查推理接入点是否处于「运行中」状态

API Key 无效

• 在方舟平台重新检查 API Key
• 确认 API Key 未过期或被删除

请求格式错误

• 确认 baseUrl 指向 https://ark.cn-beijing.volces.com/api/v3
• 使用 Endpoint ID 而非模型名称作为 model 参数

权限不足

• 确认火山引擎账号已完成实名认证
• 检查 API Key 的权限范围

 

《AI提示工程必知必会》为读者提供了丰富的AI提示工程知识与实战技能。《AI提示工程必知必会》主要内容包括各类提示词的应用，如问答式、指令式、状态类、建议式、安全类和感谢类提示词，以及如何通过实战演练掌握提示词的使用技巧；使用提示词进行文本摘要、改写重述、语法纠错、机器翻译等语言处理任务，以及在数据挖掘、程序开发等领域的应用；AI在绘画创作上的应用，百度文心一言和阿里通义大模型这两大智能平台的特性与功能，以及市场调研中提示词的实战应用。通过阅读《AI提示工程必知必会》，读者可掌握如何有效利用AI提示工程提升工作效率，创新工作流程，并在职场中脱颖而出。