Elai
  1. 实时 API
Elai
  • 简介
  • 个性化 API
    • 创建个性化视频
    • 渲染/创建个性化批次
      POST
  • 视频 API
    • 创建视频
      • 创建视频
      • 来自模板
      • 来自 PPTX/PPT
      • 复制视频
      • 翻译视频
    • 渲染视频
      POST
    • 列出视频
      GET
    • 检索视频
      GET
    • 更新视频
      PATCH
    • 删除视频
      DELETE
  • 故事 API
    • 概述
    • OpenAI GPT-3.5 增强功能
      • 通过 GPT 从头生成
      • 增强整个视频
      • 增强特定幻灯片
    • 生成/创建故事
      POST
    • 生成幻灯片/转换故事
      POST
  • 头像 API
    • 概述
    • 头像列表
      GET
    • 更新头像
      PATCH
    • 创建照片头像
      POST
  • 用户 API
    • 列出用户
      GET
    • 邀请用户
      POST
    • 更新用户
      PATCH
    • 删除用户
      DELETE
  • 语言 API
    • 语言/声音列表
    • 获取大致持续时间
  • 实时 API
    • 实时 API 概览(测试版)
    • 创建流
      POST
    • 检索流
      GET
    • 开始流
      PUT
    • 提交 webRTC 候选
      POST
    • 渲染文本
      POST
    • 关闭流
      DELETE
  • WEBHOOK
    • Webhook 概述
    • 订阅
    • 取消订阅
    • 设置秘密令牌
  • 上传媒体
    • 检索签名 URL
    • 确认上传
  1. 实时 API

创建流

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/v1/streams
要启动流式传输会话,请发出此 POST 请求。在请求正文中,您必须提供 avatarCode、voiceId 和 voiсeProvider。

🚧仅支持 elevenlabs 语音#

您可以通过语音列表API 调用获取语音 ID。目前仅支持 11 个实验室的语音。

📘仅支持特定头像#

要获取支持的头像列表,请使用realtime=true查询参数调用头像列表 API ,并使用此处特定头像对象中的代码参数。
此请求的响应将为您提供唯一的流 ID 和 webrtcData。其他请求将需要它们。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/v1/streams' \
--header 'Authorization: Bearer SECRET_KEY' \
--header 'content-type: application/json' \
--data-raw '{
  "voiceProvider": "elevenlabs"
}'
响应示例响应示例
{
  "id": "661783648dd0fe73e0846643",
  "webrtcData": {
    "offer": {
      "type": "offer",
      "sdp": "v=0\r\no=- 1305108476168966665 2 IN IP4 127.0.0.1\r\ns=-\r\nt=0 0\r\na=group:BUNDLE 0 1\r\na=msid-semantic: WMS 55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6\r\nm=audio 48174 UDP/TLS/RTP/SAVPF 111 103 104 9 102 0 8 106 105 13 110 112 113 126\r\nc=IN IP4 216.39.253.44\r\na=rtcp:9 IN IP4 0.0.0.0\r\na=candidate:2733026917 1 udp 41820671 216.39.253.44 48174 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 2 network-cost 50\r\na=candidate:897171276 1 udp 41886207 216.39.253.46 31313 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 1 network-cost 50\r\na=candidate:2733026917 1 udp 41820159 216.39.253.44 30801 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 2 network-cost 50\r\na=candidate:897171276 1 udp 41885695 216.39.253.46 11442 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 1 network-cost 50\r\na=candidate:2079998908 1 udp 25108735 216.39.253.46 16373 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 1 network-cost 50\r\na=candidate:3038349044 1 udp 25043199 104.167.196.56 61699 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 2 network-cost 50\r\na=ice-ufrag:eEkB\r\na=ice-pwd:LYFa4iqGkGFslFjxZ4VvnVhH\r\na=ice-options:trickle\r\na=fingerprint:sha-256 0B:7C:41:43:A8:92:DA:F6:B9:22:B4:F3:D6:7A:14:6E:17:E0:84:7A:28:42:BA:63:83:75:42:75:76:6C:0E:DA\r\na=setup:actpass\r\na=mid:0\r\na=extmap:1 urn:ietf:params:rtp-hdrext:ssrc-audio-level\r\na=extmap:2 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time\r\na=extmap:3 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01\r\na=extmap:4 urn:ietf:params:rtp-hdrext:sdes:mid\r\na=extmap:5 urn:ietf:params:rtp-hdrext:sdes:rtp-stream-id\r\na=extmap:6 urn:ietf:params:rtp-hdrext:sdes:repaired-rtp-stream-id\r\na=sendrecv\r\na=msid:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6 fd845451-de24-4ab3-9b19-944acd41923b\r\na=rtcp-mux\r\na=rtpmap:111 opus/48000/2\r\na=rtcp-fb:111 transport-cc\r\na=fmtp:111 minptime=10;useinbandfec=1\r\na=rtpmap:103 ISAC/16000\r\na=rtpmap:104 ISAC/32000\r\na=rtpmap:9 G722/8000\r\na=rtpmap:102 ILBC/8000\r\na=rtpmap:0 PCMU/8000\r\na=rtpmap:8 PCMA/8000\r\na=rtpmap:106 CN/32000\r\na=rtpmap:105 CN/16000\r\na=rtpmap:13 CN/8000\r\na=rtpmap:110 telephone-event/48000\r\na=rtpmap:112 telephone-event/32000\r\na=rtpmap:113 telephone-event/16000\r\na=rtpmap:126 telephone-event/8000\r\na=ssrc:748673523 cname:IvJ/7olJ7rQsoWWM\r\na=ssrc:748673523 msid:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6 fd845451-de24-4ab3-9b19-944acd41923b\r\na=ssrc:748673523 mslabel:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6\r\na=ssrc:748673523 label:fd845451-de24-4ab3-9b19-944acd41923b\r\nm=video 51237 UDP/TLS/RTP/SAVPF 96 97 98 99 100 101 127 124 125\r\nc=IN IP4 104.167.196.56\r\na=rtcp:9 IN IP4 0.0.0.0\r\na=candidate:4221204996 1 udp 41820159 104.167.196.56 51237 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 2 network-cost 50\r\na=candidate:2733026917 1 udp 41886207 216.39.253.44 34494 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 1 network-cost 50\r\na=candidate:2733026917 1 udp 41820671 216.39.253.44 49367 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 2 network-cost 50\r\na=candidate:4221204996 1 udp 41885695 104.167.196.56 59672 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 1 network-cost 50\r\na=candidate:3966063253 1 udp 25108735 216.39.253.44 45141 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 1 network-cost 50\r\na=candidate:3038349044 1 udp 25043199 104.167.196.56 62041 typ relay raddr 0.0.0.0 rport 0 generation 0 network-id 2 network-cost 50\r\na=ice-ufrag:eEkB\r\na=ice-pwd:LYFa4iqGkGFslFjxZ4VvnVhH\r\na=ice-options:trickle\r\na=fingerprint:sha-256 0B:7C:41:43:A8:92:DA:F6:B9:22:B4:F3:D6:7A:14:6E:17:E0:84:7A:28:42:BA:63:83:75:42:75:76:6C:0E:DA\r\na=setup:actpass\r\na=mid:1\r\na=extmap:14 urn:ietf:params:rtp-hdrext:toffset\r\na=extmap:2 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time\r\na=extmap:13 urn:3gpp:video-orientation\r\na=extmap:3 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01\r\na=extmap:12 http://www.webrtc.org/experiments/rtp-hdrext/playout-delay\r\na=extmap:11 http://www.webrtc.org/experiments/rtp-hdrext/video-content-type\r\na=extmap:7 http://www.webrtc.org/experiments/rtp-hdrext/video-timing\r\na=extmap:8 http://tools.ietf.org/html/draft-ietf-avtext-framemarking-07\r\na=extmap:9 http://www.webrtc.org/experiments/rtp-hdrext/color-space\r\na=extmap:4 urn:ietf:params:rtp-hdrext:sdes:mid\r\na=extmap:5 urn:ietf:params:rtp-hdrext:sdes:rtp-stream-id\r\na=extmap:6 urn:ietf:params:rtp-hdrext:sdes:repaired-rtp-stream-id\r\na=sendrecv\r\na=msid:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6 726b9265-32f9-4a11-a7ae-ed47ce0f84c7\r\na=rtcp-mux\r\na=rtcp-rsize\r\na=rtpmap:96 VP8/90000\r\na=rtcp-fb:96 goog-remb\r\na=rtcp-fb:96 transport-cc\r\na=rtcp-fb:96 ccm fir\r\na=rtcp-fb:96 nack\r\na=rtcp-fb:96 nack pli\r\na=rtpmap:97 rtx/90000\r\na=fmtp:97 apt=96\r\na=rtpmap:98 VP9/90000\r\na=rtcp-fb:98 goog-remb\r\na=rtcp-fb:98 transport-cc\r\na=rtcp-fb:98 ccm fir\r\na=rtcp-fb:98 nack\r\na=rtcp-fb:98 nack pli\r\na=fmtp:98 profile-id=0\r\na=rtpmap:99 rtx/90000\r\na=fmtp:99 apt=98\r\na=rtpmap:100 VP9/90000\r\na=rtcp-fb:100 goog-remb\r\na=rtcp-fb:100 transport-cc\r\na=rtcp-fb:100 ccm fir\r\na=rtcp-fb:100 nack\r\na=rtcp-fb:100 nack pli\r\na=fmtp:100 profile-id=2\r\na=rtpmap:101 rtx/90000\r\na=fmtp:101 apt=100\r\na=rtpmap:127 red/90000\r\na=rtpmap:124 rtx/90000\r\na=fmtp:124 apt=127\r\na=rtpmap:125 ulpfec/90000\r\na=ssrc-group:FID 4132093035 879720522\r\na=ssrc:4132093035 cname:IvJ/7olJ7rQsoWWM\r\na=ssrc:4132093035 msid:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6 726b9265-32f9-4a11-a7ae-ed47ce0f84c7\r\na=ssrc:4132093035 mslabel:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6\r\na=ssrc:4132093035 label:726b9265-32f9-4a11-a7ae-ed47ce0f84c7\r\na=ssrc:879720522 cname:IvJ/7olJ7rQsoWWM\r\na=ssrc:879720522 msid:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6 726b9265-32f9-4a11-a7ae-ed47ce0f84c7\r\na=ssrc:879720522 mslabel:55a74c0c-2fe1-4d76-abdb-67ad5a6f5fa6\r\na=ssrc:879720522 label:726b9265-32f9-4a11-a7ae-ed47ce0f84c7\r\n"
    },
    "iceServers": [
      {
        "urls": [
          "turn:standard.relay.metered.ca:80",
          "turn:standard.relay.metered.ca:80?transport=tcp",
          "turn:standard.relay.metered.ca:443",
          "turns:standard.relay.metered.ca:443?transport=tcp"
        ],
        "username": "6306537f62293ed70b1a8627",
        "credential": "3SQ/PfTTiNY04kBr"
      }
    ]
  }
}
修改于 2024-06-13 06:16:54
上一页
实时 API 概览(测试版)
下一页
检索流
Built with