接入你的 AI 直播
整体流程
  1. 1我们生成直播画面你的 AI 主播运行在我们的 GPU 机器上,持续输出一路直播视频。
  2. 2你拉流,再推到平台在你的电脑上用 OBS 或 ffmpeg 拉取这路流,再推到 YouTube、Twitch、B 站或其他平台。
  3. 3弹幕回到主播这里平台直播间里的弹幕会交给主播,主播读出来并开口回答。

你自己那场直播的地址在直播间的“拉流地址”和“接收弹幕”两个标签页里。本页的示例用的是免费体验直播,付费之前可以把每一步都先试一遍。

拉流

每场直播有两个地址,画面和声音相同。能用 SRT 就用 SRT:距离远、网络不稳时它稳定得多。只有工具打不开 SRT 时才用 RTMP。

SRT 推荐 · 体验直播
RTMP · 体验直播

体验直播正在播 体验直播的地址只在它开播时可用。机器忙别的任务时,它会离线大约 15 分钟。

地址的组成

srt://HOST:8890?streamid=read:live:viewer:PASSWORD&latency=300000 rtmp://HOST:1935/live?user=viewer&pass=PASSWORD
  • HOST 是你这场直播所在的机器,PASSWORD 是只给这一场用的密码。两者每次开播都会变,所以每次都要到直播间重新复制地址。
  • 拿到地址的人都能观看和转播你的直播,不要公开发出去。
  • 视频是 H.264,每秒 25 帧,音频是 AAC,横屏还是竖屏由你创建时选定。可以原样推到平台,不需要重新编码。

先确认能播放

配置 OBS 之前,先用播放器打开地址试一下。装好 ffmpeg 后运行下面的命令(引号要保留):

ffplay -fflags nobuffer -flags low_delay "srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000"

VLC:Media → Open Network Stream(媒体 → 打开网络串流),粘贴 RTMP 地址后点播放。

OBS

网络抖动后画面卡住不动时,在媒体源里勾选“Restart playback when source becomes active”(源激活时重新播放),或者把这个源隐藏再显示一次。

ffmpeg

你这边不需要看到画面:一条命令就能拉流并推到平台。把最后一段换成平台给你的服务器地址和推流码。

ffmpeg -i "srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000" -c copy -f flv "rtmp://a.rtmp.youtube.com/live2/YOUR_STREAM_KEY"

直播期间保持这个窗口打开。命令停了,推流就断了。

直播姬

绑定 Twitch 或 YouTube 的聊天

这是接收弹幕最简单的办法。我们替你读取平台的聊天,你不用运行任何程序,也不用把平台账号交给我们。

  • Twitch:以“!”开头的消息会被当成机器人指令跳过。
  • YouTube:必须已经开播并且开启了聊天。要粘贴的是那场直播视频的链接,不是频道链接。新消息大约每 8 秒取一次。
  • 其他平台(B 站、抖音、TikTok 等)没有内置支持,请用下面的 HTTP 接口。
用 HTTP 接口发送弹幕

用于我们不能直接读取的平台:你运行一个读取平台弹幕的程序,每条弹幕用一个 HTTP 请求转给我们。主播会把它当成普通弹幕来回答。

请求

POST · 体验直播
请求头Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
user发送者的名字,会显示在弹幕区并由主播念出来。最多 16 个字符。
text弹幕内容。最多 50 个字符,超出的部分会被截掉。

你自己那场直播的地址和 token 在直播间的“接收弹幕”标签页里。token 只在生成时显示一次;重新生成后旧的立即失效。

在体验直播上试一试

领取一个属于你的 token,在体验直播开播时运行下面任意一个示例,你的弹幕会出现在体验直播的弹幕区并得到回答。

登录后领取体验 token 打开体验直播

体验直播有两点不同:弹幕一律显示你的账号名字(user 字段会被忽略),每个账号每 5 秒只能发一条。

curl
curl -X POST 'https://dangcingai.com/api/live/demo/ingest' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"user":"Tom","text":"hello"}'
Python
import requests URL = "https://dangcingai.com/api/live/demo/ingest" TOKEN = "YOUR_TOKEN" def send(user: str, text: str) -> None: resp = requests.post(URL, json={"user": user, "text": text}, headers={"Authorization": "Bearer " + TOKEN}, timeout=10) print(resp.status_code, resp.text) send("Tom", "hello")
PowerShell
$body = @{ user = "Tom"; text = "hello" } | ConvertTo-Json Invoke-RestMethod -Method Post -Uri "https://dangcingai.com/api/live/demo/ingest" ` -Headers @{ Authorization = "Bearer YOUR_TOKEN" } ` -ContentType "application/json; charset=utf-8" -Body $body

返回结果

200{"id": 123}已收下。轮到它时主播会回答。
400bad_texttext 为空,或者不是字符串。
401unauthorizedtoken 缺失或不正确,或者已经被新生成的 token 取代。
409offline这场直播现在没有在播。
429too_fast发得太多了。这一条已被丢弃,不要重发,过一会儿再发下一条。
503server_error我们这边出了问题,请稍后再试。

限制

  • 主播一次只回答一条弹幕,一次回答要几秒钟。一场直播每分钟最多收 20 条,所有来源合在一起计算。
  • 已有 3 条在等待时,新来的会被丢弃而不是排队,因为没人想听一分钟前那条弹幕的回答。弹幕很多时,请先挑出值得回答的再转发。
  • 含有屏蔽词的弹幕不会被念出来,也不会出现在弹幕区。
常见问题
OBS 或播放器里没有画面

先确认直播正在播,再重新复制一次地址:机器和密码每场都会变。RTMP 连不上时改用 SRT,并确认你的网络允许向外访问 UDP 8890 端口。

画面卡顿或声音断续

请用 SRT 地址和有线网络。直播机器在中国,从其他大洲用 RTMP 拉流常常跟不上,而 SRT 能在地址里设定的延迟时间内补回丢失的数据。

主播没有回答某条弹幕

主播一次只回答一条,弹幕多的时候大部分会被跳过。含有屏蔽词的弹幕,以及请求返回 429 的弹幕,也不会被回答。

直播的延迟有多大?

弹幕送到后,主播几秒内开口。拉流再推流会多出几秒,平台自己还有一段延迟,所以在平台上听到回答会比在本站直播间里明显晚一些。