add-provider

添加 Bolna 提供商

端点

• 添加提供商：POST https://api.bolna.ai/providers
• 列出提供商：GET https://api.bolna.ai/providers
• 移除提供商：DELETE https://api.bolna.ai/providers/{provider_key_name}

使用 Authorization: Bearer $BOLNA_API_KEY。添加时使用 Content-Type: application/json。

提供商类别

• 电话服务：Twilio、Plivo、Exotel、Vobiz、SIP 中继及其他受支持的呼叫服务提供商。
• 大模型：OpenAI、Azure OpenAI、Anthropic、OpenRouter、DeepSeek、自定义 LiteLLM 兼容模型。
• 转录器：Deepgram、Sarvam、AssemblyAI、Azure、ElevenLabs Scribe、Gladia、Pixa。
• 语音/TTS：ElevenLabs、Cartesia、Deepgram、Azure TTS、AWS Polly、Rime、Sarvam、Smallest。

选择具体凭据字段前，请查看 Bolna 当前的提供商文档，因为提供商架构可能会发生变化。

安全工作流

1. 确定提供商类型和确切名称。
2. 请用户确认凭据已准备好。
3. 切勿将密钥粘贴到已提交的文件中。
4. 通过 API 或控制面板添加提供商。
5. 列出提供商，以获取返回的提供商 ID。
6. 根据 Bolna 文档的要求，在 Agent 配置中使用提供商 ID 或提供商名称。
7. 在用于生产环境的批量操作前，先使用测试 Agent 或呼叫进行测试。

添加提供商的数据结构

Bolna 会将提供商凭据存储为具名键。请使用 Bolna 要求的提供商键名，然后填写密钥值。

{
  "provider_name": "OPENAI",
  "provider_value": "sk-0123456789az"
}

常见提供商键名会映射到相应的集成，例如 OpenAI、Anthropic、ElevenLabs、Deepgram、Sarvam、Cartesia 的 API 密钥，或 Twilio、Plivo、Exotel 和 Vobiz 的电话凭据。创建新的键名之前，请查看 Bolna 当前的提供商页面。

curl --request POST \
  --url https://api.bolna.ai/providers \
  --header "Authorization: Bearer $BOLNA_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "provider_name": "OPENAI",
    "provider_value": "sk-0123456789az"
  }'

列出提供商

curl --request GET \
  --url https://api.bolna.ai/providers \
  --header "Authorization: Bearer $BOLNA_API_KEY"

移除提供商

curl --request DELETE \
  --url "https://api.bolna.ai/providers/$PROVIDER_KEY_NAME" \
  --header "Authorization: Bearer $BOLNA_API_KEY"

请先确认是否移除。如果移除了已配置的提供商键，现有 Agent 可能会失效。

常见凭据键名

提供商	属性
OpenAI	OPENAI
OpenRouter	OPENROUTER
Google Gemini	GOOGLE
Azure OpenAI	AZURE_OPENAI_API_KEY, AZURE_OPENAI_MODEL, AZURE_OPENAI_API_BASE, AZURE_OPENAI_API_VERSION
ElevenLabs	ELEVENLABS
Cartesia	CARTESIA
Sarvam	SARVAM
Smallest	SMALLEST
Deepgram	DEEPGRAM
Twilio	TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER
Plivo	PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN, PLIVO_PHONE_NUMBER
Vobiz	VOBIZ_AUTH_ID, VOBIZ_AUTH_TOKEN, VOBIZ_PHONE_NUMBER
Exotel	EXOTEL_API_KEY, EXOTEL_API_TOKEN, EXOTEL_ACCOUNT_SID, EXOTEL_DOMAIN, EXOTEL_PHONE_NUMBER, EXOTEL_OUTBOUND_APP_ID, EXOTEL_INBOUND_APP_ID
自定义大模型	在 Agent 的 llm_agent 中使用 provider: "custom" 和兼容 OpenAI 的 base_url，然后调用 POST /user/model/custom 注册模型名称。

完整的提供商对照表（包括各提供商适用的语言/用例）见 https://raw.githubusercontent.com/bolna-ai/skills/main/references/providers-matrix.md。

另请参阅

• https://raw.githubusercontent.com/bolna-ai/skills/main/references/providers-matrix.md — 延迟经验法则、语言覆盖范围及常见搭配。
• setup-sip-trunk — SIP 中继提供商（使用不同的端点，不属于凭据库）。
• create-agent — 在 llm_agent、synthesizer、transcriber 中配置提供商名称。