Подключите свой ИИ-эфир
Как отправить ИИ-эфир на стриминговую платформу и как передать ведущему сообщения из чата ваших зрителей.
- 1Мы создаём потокВаш ИИ-ведущий работает на нашей машине с GPU и выдаёт поток живого видео.
- 2Вы получаете его и отправляете дальшеOBS или ffmpeg на вашем компьютере получает поток и отправляет его на YouTube, Twitch, Bilibili или любую другую платформу.
- 3Чат возвращается к ведущемуСообщения из чата вашей платформы передаются ведущему — он читает их и отвечает вслух.
Адреса вашего собственного эфира указаны на странице «Мой эфир», в разделах «Адрес потока» и «Приём чата». В примерах на этой странице используется бесплатный демо-поток, так что вы можете опробовать каждый шаг до оплаты.
У каждого эфира есть два адреса с одним и тем же изображением и звуком. По возможности используйте SRT: он гораздо лучше справляется с большими расстояниями и нестабильными сетями. RTMP используйте, только если ваша программа не умеет открывать SRT.
srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000
rtmp://117.50.34.91:1935/live?user=demo&pass=d38f2f1b37
Демо сейчас в эфире Демо-адреса работают, только пока демо в эфире. Оно уходит из сети примерно на 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 и нажмите Play.
OBS
- В OBS добавьте «Источник медиа» и снимите флажок «Локальный файл».
- Вставьте адрес SRT в поле «Ввод».
- В разделе «Настройки → Трансляция» укажите сервер и ключ потока вашей платформы.
- Нажмите «Запустить трансляцию».
Если после сбоя сети изображение застыло, включите «Restart playback when source becomes active» в Media Source либо один раз скройте и снова покажите источник.
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"
Не закрывайте окно, пока идёт эфир. Поток работает, только пока выполняется эта команда.
Bilibili Live
- Откройте Bilibili Live (直播姬) и добавьте источник «Поток».
- Вставьте адрес RTMP.
- Начните трансляцию в приложении как обычно.
Самый простой способ принимать чат. Мы читаем чат вашей платформы за вас; вам не нужно ничего запускать или давать нам доступ к своему аккаунту.
- Запустите эфир здесь и начните трансляцию на своей платформе.
- На странице «Мой эфир» откройте вкладку «Приём чата» и выберите платформу.
- Вставьте название своего канала Twitch или ссылку на свою трансляцию YouTube и нажмите «Подключить».
- Когда на значке появится «Подключено», сообщения ваших зрителей начнут появляться в чате комнаты, а ведущий будет на них отвечать.
- Twitch: сообщения, которые начинаются с «!», считаются командами для ботов и пропускаются.
- YouTube: трансляция уже должна идти, а чат должен быть включён. Вставьте ссылку на само видео трансляции, а не на канал. Новые сообщения приходят примерно раз в 8 секунд.
- Другие платформы (Bilibili, Douyin, TikTok и так далее) не встроены. Используйте HTTP-интерфейс ниже.
Для любой платформы, которую мы не читаем напрямую: запустите программу, которая читает чат вашей платформы и пересылает нам каждое сообщение одним HTTP-запросом. Ведущий обрабатывает его как любое другое сообщение чата.
Запрос
https://dangcingai.com/api/live/demo/ingest
| Заголовок | Authorization: Bearer YOUR_TOKENContent-Type: application/json |
|---|---|
user | Имя отправителя: показывается в чате и зачитывается ведущим. Не более 16 символов. |
text | Сообщение. Не более 50 символов; всё, что длиннее, обрезается. |
Адрес и токен для вашего собственного эфира находятся на странице «Мой эфир», в разделе «Приём чата». Токен показывается один раз — при создании; создание нового токена отменяет старый.
Попробуйте на демо
Получите личный токен, запустите один из примеров, пока демо в эфире, и посмотрите, как ваше сообщение появится в чате демо и получит ответ.
Войдите, чтобы получить демо-токен Открыть демо
В демо есть два отличия: сообщения всегда показываются под именем вашего аккаунта (поле user игнорируется), и каждый аккаунт может отправлять одно сообщение раз в 5 секунд.
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"}'
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")
$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} | Принято. Ведущий ответит, когда до сообщения дойдёт очередь. |
|---|---|---|
400 | bad_text | Поле text пустое или не является строкой. |
401 | unauthorized | Токен отсутствует или неверен либо был заменён более новым. |
409 | offline | Эфир сейчас не идёт. |
429 | too_fast | Слишком много сообщений. Это сообщение отброшено; не отправляйте его повторно, отправьте следующее позже. |
503 | server_error | Проблема на нашей стороне. Повторите попытку чуть позже. |
Ограничения
- Ведущий отвечает на одно сообщение за раз, и ответ занимает несколько секунд. Для одного эфира принимается не более 20 сообщений в минуту, считая все источники вместе.
- Когда 3 сообщения уже ждут ответа, новые не ставятся в очередь, а отбрасываются: ответ на сообщение минутной давности никому не нужен. В оживлённом чате отбирайте сообщения, на которые стоит ответить, прежде чем пересылать их.
- Сообщения с запрещёнными словами не зачитываются и не появляются в чате.
В OBS или плеере ничего не показывается
Убедитесь, что эфир идёт, затем скопируйте адрес заново: хост и пароль меняются с каждым сеансом. Если RTMP не подключается, попробуйте SRT и проверьте, что ваша сеть разрешает исходящий UDP на порт 8890.
Изображение дёргается или звук прерывается
Используйте адрес SRT и проводное подключение. Машины для трансляции находятся в Китае, поэтому с других континентов RTMP часто не справляется, а SRT восстанавливает потерянные данные в пределах задержки, заданной в адресе.
Ведущий не отвечает на сообщение
Ведущий отвечает на одно сообщение за раз, поэтому в оживлённом чате большинство сообщений пропускается. Сообщение также пропускается, если в нём есть запрещённые слова или если на запрос пришёл ответ 429.
Насколько отстаёт поток?
Ведущий начинает говорить через несколько секунд после получения сообщения. Получение и отправка потока добавляют ещё несколько секунд, а платформа добавляет сверху собственную задержку, поэтому на платформе зрители слышат ответ заметно позже, чем в комнате на этом сайте.