Changelog

新增端点

ElevenAgents

• 获取对话的 SIP 消息 - GET /v1/convai/conversations/{conversation_id}/sip-messages
  • 新增必需路径参数 conversation_id（字符串）
  • 新增可选查询参数 page_size（整数，默认 20）和 cursor
  • 返回 GetSIPLogMessagesResponse，包含 sip_messages、可为空的 next_cursor 和 has_more
• 获取电话号码的 SIP 消息 - GET /v1/convai/phone-numbers/{phone_number_id}/sip-messages
  • 新增必需路径参数 phone_number_id（字符串）
  • 新增可选查询参数 page_size（整数，默认 20）和 cursor
  • 返回 GetSIPLogMessagesResponse
• 获取文档的 RAG 分块 - GET /v1/convai/knowledge-base/{documentation_id}/chunks
  • 新增必需路径参数 documentation_id（字符串）
  • 新增必需查询参数 embedding_model
  • 新增可选查询参数 page_size（整数，默认 30）和 cursor
  • 返回 KnowledgeBaseDocumentChunksResponseModel，包含 chunks 和可为空的 next_cursor
• 更新文档文件 - PATCH /v1/convai/knowledge-base/{documentation_id}/update-file
  • 新增必需路径参数 documentation_id（字符串）
  • 新增 multipart 表单主体，包含必需的 file（字符串，二进制）
  • 返回更新后的知识库文档模型

工作区

• POST /v1/workspace/analytics/requests
  • 新增请求主体，包含可选的 start_time、end_time、limit（整数，默认 100，最大 1000）、sort、filters 和 search
  • 返回 WorkspaceAnalyticsQueryResponseModel，包含 columns、column_types、rows 和 column_units

已更新端点和架构

ElevenAgents

• 更新知识库文档 - PATCH /v1/convai/knowledge-base/{documentation_id}
  • 新增 JSON 请求主体字段 name（可选、可为空的字符串）和 content（可选、可为空的字符串）
• 创建智能体 - POST /v1/convai/agents/create
  • 将 enable_versioning 默认值从 false 改为 true
• 更新智能体 - PATCH /v1/convai/agents/{agent_id}
  • 将 enable_versioning_if_not_enabled 默认值从 false 改为 true
• 更新电话号码 - PATCH /v1/convai/phone-numbers/{phone_number_id}
  • 在电话号码智能体配置中新增 environment 和 branch_id
  • store_sip_messages 现在默认值为 true
• 获取组件 - GET /v1/convai/agents/{agent_id}/widget
  • 新增用于组件文件上传的 file_input_config
• LLM 枚举
  • 新增 gpt-5.4-mini、gpt-5.4-nano、gpt-5.4-mini-2026-03-17 和 gpt-5.4-nano-2026-03-17
• AuthorizationMethod 枚举
  • 新增 sms
• ConversationInitiationSource 枚举
  • 新增 twilio_sms
• AgentTopicResponseModel
  • 新增可选、可为空的 parent_topic_id、x_2d 和 y_2d
• BackgroundMusicConfig 和 BackgroundMusicConfigWorkflowOverride
  • 新增 source_type、source_id、volume 和 crossfade_loop
  • 新增 BackgroundMusicPresetId 枚举值 city、elevator1、elevator2、elevator3、elevator4、office1、office2、restaurant 和 typing
• AgentPlatformSettingsResponseModel
  • 新增 alerting，其 Monitor 枚举值包括 elevated_conversation_failure_rate 和 elevated_tool_failure_rate
• ProcedureCompilerMode 枚举
  • 移除 deterministic

工作区

• 服务账号 API 密钥创建和编辑架构
  • 新增 allowed_ips，作为包含 1 至 100 个 IP 地址或 CIDR 范围的可选数组
  • 创建请求可传入 null 以允许所有 IP
  • 编辑请求可传入 clear 或 no_update；默认值为 no_update
• WorkspaceApiKeyResponseModel
  • 新增可为空的 allowed_ips
• WorkspaceGroupPermission 枚举
  • 新增 conversational_ai_read 和 voice_design
• 身份验证连接架构
  • 为用户拥有的 OAuth2 自定义应用连接新增 ApiIntegrationOAuth2CustomAppResponse

声音设计

• 创建声音预览 - POST /v1/text-to-voice/create-previews
  • 标记为已弃用
  • 更新说明，引导开发者使用设计声音

变声器

• 语音转语音 - POST /v1/speech-to-speech/{voice_id}
  • 在 output_format 枚举中新增 wav_8000、wav_16000、wav_22050、wav_24000、wav_32000、wav_44100 和 wav_48000
  • 更新说明，注明 PCM 和 WAV 44.1 kHz 格式需要 Pro 或更高套餐