Reception API
从自有系统创建和管理客户的 Reception.ai 工作区。
Reception API 让 Reception.ai 经销商能通过代码完成在经销商管理面板中手动执行的操作:为每位客户创建工作区、为其销售你的套餐、设置接待员,并跟踪信用卡扣费情况。所有端点均位于 https://api.elevenlabs.io/v1/reception 下,并在 Python 和 TypeScript SDK 中以 reception 提供。
经销商管理面板及 Reception API 仅向 Reception.ai 合作伙伴开放。如果 有意与我们合作,请联系销售团队。
身份验证
在经销商管理面板中创建 API 密钥。只有在那里创建的密钥才能调用 Reception API;其他 ElevenLabs API 密钥都会因 not_a_reseller_api_key 而被拒绝。该密钥只显示一次,请存储在密钥管理器中。
在 xi-api-key 标头中发送密钥,或设置 ELEVENLABS_API_KEY 让 SDK 自动读取。
经销商和工作区端点
API 在两个层级上运行。
工作区端点需要 xi-workspace-id 标头,设为你创建的工作区 ID。未提供该标头的请求,或针对属于其他经销商的工作区的请求,都会被拒绝。在 SDK 中,该标头在 Python 里是 xi_workspace_id 参数,在 TypeScript 中是 xiWorkspaceId 字段。
分页
workspaces.list 和 billing.list_invoices 每次返回一页。将响应中的 next_cursor 作为 cursor 传入以获取下一页,并在 has_more 为 false 时停止。
速率限制
限制按经销商计算,覆盖其所有 API 密钥:
超过限制的请求会返回 429。请等待后重试。