错误统一为:
{
"error": {
"type": "invalid_request_error",
"code": "invalid_agent_field",
"message": "status must be draft or published",
"param": "status"
}
}
| 状态码 | 含义 |
|---|---|
| 400 | 输入无效(code 和 param 说明是哪个字段) |
| 401 | 缺少或无效的 API 密钥 |
| 402 | Credits 不足,无法开始通话 |
| 403 | 密钥只读,或 Agent 不可用 |
| 404 | 工作区里没有这个 Agent、通话或外呼任务 |
| 409 | 状态不对(如开始一个正在运行的任务)、服务商账号未连接,或号码在拒呼名单上(do_not_call) |
| 429 | 请求过多,请放慢后重试 |
工作区最近 30 天的 Voice API 请求(时间、接口、状态码、耗时、使用的密钥和错误码,不含请求和返回内容)可以在“API 密钥”页的“API 请求日志”里查看。
读取每个密钥每分钟最多 120 次,写入和外呼每分钟最多 30 次。
通话按分钟从工作区的 Credits 扣费,和工作台共用同一个余额。当前费率见定价页。