Bland AI 开发指南：API、定价与教程（2026）

Bland AI 是用于构建真实拨打和接听电话的 AI 智能体平台。它把电话通信、语音识别、语音合成、对话逻辑、工具调用、转接、测试和通话分析整合为托管服务。

原型可以向单个端点提交电话号码和自然语言任务；生产流程则可使用可视化 Conversational Pathway，连接 API 与知识库、把部分通话交给人工，再用 webhook 把结果返回应用。

本指南介绍 API、首次通话、主要功能费用，以及它相对于模块化语音技术栈的位置。

Bland AI 是什么？

平台负责自动电话对话所需基础设施。开发者定义目标，选择对话控制程度，并连接其他业务系统。常见用途包括：

• 线索筛选与跟进。
• 预约、确认和改期。
• 常规客服。
• 电话采集结构化信息。
• 通话中查询订单、账户或空闲时段。
• 转接到正确的人工团队。
• 调查、提醒和外呼活动。

它不仅能说话，还能查知识库、调用外部 API、更新 CRM、预约和转接；结束后返回逐字稿、摘要、提取变量、处理结果、时长及元数据。

API 速查

教程：拨打第一个电话

1. 创建账户并获取密钥

注册后从开发者控制台复制 API 密钥，保存在服务端环境变量，绝不能放进浏览器或移动端代码。下例使用 BLAND_API_KEY。

2. 用 cURL 发起通话

Send Call API需要 E.164 格式的号码和任务。Authorization 值直接使用密钥。

curl --request POST \
  --url https://us.api.bland.ai/v1/calls \
  --header "Authorization: $BLAND_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "phone_number": "+15551234567",
    "task": "Call the customer to confirm tomorrow’s appointment. If the time no longer works, collect two preferred alternatives. Never invent availability."
  }'

成功响应类似：

{
  "status": "success",
  "call_id": "9d404c1b-6a23-4426-953a-a52c392ff8f1"
}

请求只把通话加入队列，不等待对话结束。

3. 用 TypeScript 发起通话

Node.js 原生 fetch 可以发送同一请求：

const response = await fetch("https://us.api.bland.ai/v1/calls", {
  method: "POST",
  headers: {
    Authorization: process.env.BLAND_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+15551234567",
    task: [
      "Confirm tomorrow's appointment.",
      "If the time does not work, collect two preferred alternatives.",
      "Do not claim a new time is booked until the scheduling tool confirms it.",
    ].join(" "),
  }),
});
 
if (!response.ok) {
  throw new Error(`Bland API request failed: ${response.status}`);
}
 
const call = (await response.json()) as {
  status: "success" | "error";
  call_id?: string;
  message?: string;
};
 
console.log(call.call_id);

仅在可信服务端运行；前端调用会向所有访问者暴露密钥。

4. 获取结果

将 ID 传给通话详情端点，或配置通话结束 webhook 来避免轮询。

curl --request GET \
  --url https://us.api.bland.ai/v1/calls/CALL_ID \
  --header "Authorization: $BLAND_API_KEY"

详情可能包含状态、逐字稿、摘要、时长、录音信息和变量。只保存业务需要的字段，并在采集生产通话前制定保留规则。

从演示走向生产：Task、Pathway 还是 Persona？

用 Task 验证概念

提醒、确认一个细节或询问短问题列表适合 Task。围绕可观察结果写提示词，说明：联系谁及原因、可用信息、成功标准、禁止猜测或修改的事项、何时转接改期或结束，以及语音信箱和拒绝联系的处理。若积累许多 if，应转为 Pathway。

用 Pathways 控制工作流

Conversational Pathways是节点式可视化编排器。节点可生成对话、说固定句子、收集变量、查知识库、调用 webhook、转接或结束。带标签的分支限制合法下一步，同时允许理解自然语言。

预约智能体可分别处理确认原时间、请求新时间、诊所问题、未知来电人、转接员工和记录拒绝联系后结束。这比一个长系统提示词更易审核、测试和修改。

工具、知识与真实操作

内置集成和自定义 HTTP 工具让智能体在通话中查空闲、取订单、更新 CRM 或调用内部服务。知识库提供问答依据，动态数据提供姓名、预约时间、账户状态和活动 ID 等单次上下文。

读取预约和取消预约属于不同权限。应分开读写权限、验证输入、使写操作幂等，并在不可逆操作前确认。

Webhook、转接与电话运营

通话后和实时事件

外呼请求中的 webhook 用于接收结束结果；webhook_events 可订阅队列、通话、延迟、工具和转接等实时事件。

{
  "phone_number": "+15551234567",
  "pathway_id": "YOUR_PATHWAY_ID",
  "request_data": {
    "customer_name": "Jordan",
    "appointment_date": "September 20, 2026"
  },
  "metadata": {
    "customer_id": "cus_123",
    "campaign": "appointment-confirmation"
  },
  "webhook": "https://example.com/webhooks/bland"
}

通话后 webhook 指南介绍全局和单次配置。生产环境需验证签名、快速返回成功、异步处理昂贵任务，并支持重试与重复投递。

人工转接

平台可转接单个号码、按意图分配团队，或使用 Pathway 转接节点。应将接手视为正常状态：说明原因、传递已收集事实，并定义无人可接时的行为。缺乏上下文的转接会迫使客户重述，也会掩盖失败指标。

呼入与电话网络

在控制台购买或启用号码并分配智能体，各号码可配置独立行为和 webhook。已有运营商基础设施可接 Twilio，企业还可使用 SIP。

号码供应、运营商费用、地区、转接和监管义务各有差异，应在每个目标市场验证整条电话链路。

批量外呼

Batch Calls用 CSV 或 API 发起活动，按收件人变量提供姓名、预约和账户上下文。

先从小群体开始，测量接听率、完成率、拒绝联系、转接和成本，再增加并发。增加通话只会放大现有质量与合规表现。

测试与监控

真实来电人会打断、沉默、只给部分信息、拼写姓名、进入语音信箱、换话题或要求人工。脚本演示成功不代表生产就绪。测试工具包括：

• Testbed： 用真实通话数据迭代节点。
• Scenarios： 模拟来电人和预期场景。
• Standards： 把已知交互变为可重复回归检查。
• Evals： 按可配置质量条件评分。
• Guard Rails： 实时监测，不满足条件时触发操作。
• Alerts： 指标或自定义条件越界时通知团队。

模型具有随机性，重要场景应重复测试。除正常路径，还需覆盖沉默、打断、噪声、口音、数字、专名、工具超时、员工不可用和明确拒绝联系。Guard Rails 是额外控制，不能代替有限权限、同意管理、代表性监控或法律审查。

CLI 与 MCP

Bland CLI覆盖通话、Pathways、号码、日志、本地 webhook 转发、验证、测试和环境晋级，更便于审核与重复执行。

MCP 服务器可连接 Codex、Cursor、Claude Code、VS Code 等客户端，通过结构化工具管理账户与资源。MCP 是开发和运维接口，不是电话里实时说话的语音模型。

2026 年价格

以下为 2026 年 9 月 19 日核对的公开价格：

Start 包含两份初始额度和一个呼入号码，不是无限免费通话。接通时间按秒计费，分钟费含 LLM、语音识别和语音合成；运营商和号码另计。成本可估算为：

monthly cost ≈ platform fee
             + connected minutes × talk-time rate
             + transfer minutes × transfer rate
             + carrier, phone-number, and optional feature charges

只按 $0.02 的分钟差价，Build 的 $299 平台费约需每月 14,950 接通分钟才能抵消，但团队也可能因并发和每日限制更早升级。预测时要考虑接听率、平均时长、转接率和失败尝试。

可使用按成本转收的内置运营商、客户 Twilio 或企业 SIP。自带电话网络不付 Bland 转接费，但仍付运营商和 AI 用量。

Enterprise 提供专用基础设施、本地或 VPC 部署、SSO、数据驻留、BAA、更高限额和驻场工程等选项。购买前核对官方价格页。

独立的 Agent Phone Plan

另有每月 $29.99 的 Agent Phone Plan，为单个自主智能体提供一个美国号码，用于美国和加拿大语音与短信，受合理使用限制，同一时间仅一通。它适合助手拥有自己的电话，不是高流量联络中心套餐。

与 Vapi、Retell 和自建比较

关键是团队愿意自行组装和运营多少语音组件。

重视上线速度、AI 层计费可预测和统一操作面时，Bland 更有吸引力；供应商可迁移性或精细控制是核心要求时，可选模块化方案。

优点与限制

优点

• 一个 API 覆盖呼入呼出，基础调用易做原型。
• Pathways 比单一长提示词更可控。
• 集成工具、知识、转接、批量和 webhook。
• 测试、评估、Guard Rails 和告警支持生产运营。
• CLI 和 MCP 适合代码优先团队。
• Twilio、SIP 和企业部署覆盖复杂电话需求。
• 分钟费整合 LLM、识别和合成。

限制

• 专有 Pathways 和提示词增加迁移工作。
• 难以逐项更换底层模型或语音供应商。
• 标价不涵盖全部运营商、号码、转接和可选费用。
• 部分治理和高级路由仅企业版提供。
• 仍需按真实用户、语言、工具和电话线路测试质量与延迟。

何时适合？

电话是核心工作流，需要同平台呼入呼出、实时数据、操作、分支和人工接手时可考虑。运营想要可视化构建器、开发者又需 API 和 CLI 时尤其合适。

单一低量通知可能用不上完整平台；若必须完全控制模型、语音供应商或开源运行时，也可能不匹配。

生产检查清单

1. 可测目标： 确认、筛选、预约、采集、路由或解决具体事项。
2. 限制权限： 只提供目标所需数据与操作。
3. 人工接手： 传递上下文，定义非工作时间行为并统计失败转接。
4. 同意与拒绝联系： 请合资格专业人士确认各地区披露、录音、呼叫时段和禁呼要求。
5. 集成安全： 服务端保存密钥、验签、工具认证、幂等写入。
6. 困难对话： 覆盖沉默、打断、口音、信箱、噪声、工具失败和脚本外请求。
7. 完整漏斗： 接听、完成、升级、拒绝联系、延迟、重试及每次成功总成本。
8. 逐步放量： 先内部，再小规模代表性客户，有数据支持后增加限额。

常见问题

有 API 吗？

有，REST API 覆盖通话、Pathways、号码、工具、知识库、批量、测试和日志；基础外呼为 POST /v1/calls。

哪里获取密钥？

登录开发者控制台，在 Authorization 中直接使用，不加 Bearer，保存在服务端机密存储。

能接电话吗？

能，启用或导入号码，绑定智能体并配置 Pathway、提示词和 webhook。外呼可用 API、控制台或批量功能。

多少钱？

Start 无平台费，每接通分钟 $0.14；Build 每月 $299 加 $0.12/分钟。转接、运营商、号码和可选服务另计，企业定制。

免费吗？

可免费起步，Start 提供初始额度，但持续接通通话按用量收费。

支持 HIPAA 工作负载吗？

Bland 表示 Enterprise 签署 BAA 后可支持。供应商功能不等于应用自动合规，仍需法律和安全团队审查数据流、访问、保留、录音和运营控制。

可连接 Codex 等编程智能体吗？

可以，官方提供 Codex、Cursor、Claude Code、VS Code 等的 MCP 配置。编程智能体管理资源，语音智能体负责实时通话。

结论

Bland 把复杂实时语音栈变为直接的开发接口：定义对话、连接业务、绑定号码并调用 API。Task 可快速验证想法，Pathways、工具、webhook、测试和转接则提供真实工作流的控制。

托管平台带来速度、集成工具和较简单计费，也意味着接受其工作流、价格和关键路径依赖。若这些约束适合，可在不自建全部语音基础设施的情况下部署电话智能体。