Connecter votre live IA
Comment envoyer votre live IA vers une plateforme de streaming et transmettre le chat de vos spectateurs à l’animateur.
- 1Nous produisons le fluxVotre animateur IA tourne sur l’une de nos machines GPU et produit un flux vidéo en direct.
- 2Vous le récupérez et le rediffusezOBS ou ffmpeg, sur votre ordinateur, récupère le flux et l’envoie vers YouTube, Twitch, Bilibili ou toute autre plateforme.
- 3Le chat revient à l’animateurLes messages du chat de votre plateforme sont transmis à l’animateur, qui les lit et y répond à voix haute.
Les adresses de votre propre live se trouvent dans le salon de votre live, sous « Adresse du flux » et « Recevoir le chat ». Les exemples de cette page utilisent le flux de démo gratuit : vous pouvez ainsi essayer chaque étape avant de payer.
Chaque live a deux adresses pour la même image et le même son. Utilisez SRT dès que possible : il supporte beaucoup mieux les longues distances et les réseaux instables. N’utilisez RTMP que si votre outil ne peut pas ouvrir 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
La démo est en direct Les adresses de la démo ne fonctionnent que lorsque la démo est en direct. Elle passe hors ligne pendant environ 15 minutes chaque fois que la machine est occupée par une autre tâche.
De quoi se compose l’adresse
srt://HOST:8890?streamid=read:live:viewer:PASSWORD&latency=300000
rtmp://HOST:1935/live?user=viewer&pass=PASSWORD
- HOST est la machine sur laquelle tourne votre live et PASSWORD est un mot de passe créé pour cette seule session. Les deux changent à chaque nouveau live : recopiez donc les adresses depuis le salon de votre live à chaque fois.
- Toute personne disposant de l’adresse peut regarder et rediffuser votre live. Ne la publiez pas.
- Le flux est une vidéo H.264 à 25 images par seconde avec un son AAC, au format paysage ou portrait que vous avez choisi. Il peut être envoyé tel quel vers une plateforme, sans réencodage.
Vérifier que la lecture fonctionne
Avant de configurer OBS, ouvrez l’adresse dans un lecteur. Si ffmpeg est installé, exécutez cette commande (conservez les guillemets) :
ffplay -fflags nobuffer -flags low_delay "srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000"
Dans VLC : Media → Open Network Stream, collez l’adresse RTMP, puis Play.
OBS
- Dans OBS, ajoutez une Source média et décochez « Fichier local ».
- Collez l'adresse SRT dans Entrée.
- Dans Paramètres → Stream, saisissez le serveur et la clé de stream de votre plateforme.
- Cliquez sur Démarrer le streaming.
Si l’image se fige après une coupure réseau, cochez « Restart playback when source becomes active » dans la Media Source, ou masquez puis réaffichez la source une fois.
ffmpeg
Aucune image n’est nécessaire de votre côté : une seule commande récupère le flux et l’envoie vers votre plateforme. Remplacez la dernière partie par l’adresse du serveur et la clé de stream fournies par votre plateforme.
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"
Laissez la fenêtre ouverte tant que vous êtes en live. Le flux ne reste actif que tant que cette commande s’exécute.
Bilibili Live
- Ouvrez Bilibili Live (直播姬) et ajoutez une source « Stream ».
- Collez l'adresse RTMP.
- Lancez la diffusion depuis l'application comme d'habitude.
Le moyen le plus simple de recevoir le chat. Nous lisons le chat de votre plateforme pour vous ; vous n’avez rien à exécuter et n’avez pas à nous donner accès à votre compte.
- Lancez votre live ici et commencez à diffuser sur votre plateforme.
- Dans le salon de votre live, ouvrez l’onglet « Recevoir le chat » et choisissez la plateforme.
- Collez le nom de votre chaîne Twitch ou le lien de votre live YouTube, puis cliquez sur « Connecter ».
- Lorsque le badge indique « Connecté », les messages de vos spectateurs apparaissent dans le chat du salon et l’animateur y répond.
- Twitch : les messages qui commencent par « ! » sont considérés comme des commandes de bot et ignorés.
- YouTube : le live doit déjà être en cours, avec le chat activé. Collez le lien de la vidéo en direct elle-même, pas celui de la chaîne. Les nouveaux messages arrivent toutes les 8 secondes environ.
- Les autres plateformes (Bilibili, Douyin, TikTok, etc.) ne sont pas intégrées. Utilisez l’interface HTTP ci-dessous.
Pour toute plateforme que nous ne lisons pas directement : exécutez un programme qui lit le chat de votre plateforme et nous transmet chaque message par une requête HTTP. L’animateur le traite comme n’importe quel autre message du chat.
Requête
https://dangcingai.com/api/live/demo/ingest
| En-tête | Authorization: Bearer YOUR_TOKENContent-Type: application/json |
|---|---|
user | Le nom de l’expéditeur, affiché dans le chat et lu à voix haute par l’animateur. 16 caractères au maximum. |
text | Le message. 50 caractères au maximum ; tout ce qui dépasse est coupé. |
Pour votre propre live, l’adresse et le token se trouvent dans le salon de votre live, sous « Recevoir le chat ». Le token n’est affiché qu’une fois, au moment où vous le générez ; en générer un nouveau annule l’ancien.
Essayer sur la démo
Obtenez un token personnel, exécutez l’un des exemples pendant que la démo est en direct et regardez votre message apparaître dans le chat de la démo et recevoir une réponse.
Connectez-vous pour obtenir un token de démo Ouvrir la démo
Deux choses diffèrent sur la démo : les messages apparaissent toujours sous le nom de votre compte (le champ user est ignoré), et chaque compte peut envoyer un message toutes les 5 secondes.
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
Réponses
200 | {"id": 123} | Accepté. L’animateur y répondra quand son tour viendra. |
|---|---|---|
400 | bad_text | Le texte est vide ou n’est pas une chaîne de caractères. |
401 | unauthorized | Le token est absent ou incorrect, ou il a été remplacé par un plus récent. |
409 | offline | Le live n’est pas à l’antenne pour le moment. |
429 | too_fast | Trop de messages. Celui-ci a été ignoré ; ne le renvoyez pas, envoyez le suivant plus tard. |
503 | server_error | Un problème de notre côté. Réessayez dans un instant. |
Limites
- L’animateur répond à un message à la fois, et une réponse prend plusieurs secondes. Au maximum 20 messages par minute sont acceptés pour un même live, toutes sources confondues.
- Lorsque 3 messages sont déjà en attente, les nouveaux sont ignorés au lieu d’être mis en file d’attente, car personne ne veut d’une réponse à un message vieux d’une minute. Dans un chat très actif, choisissez les messages qui méritent une réponse avant de les transmettre.
- Les messages contenant des mots bloqués ne sont pas lus à voix haute et n’apparaissent pas dans le chat.
OBS ou le lecteur n’affiche rien
Vérifiez que le live est à l’antenne, puis recopiez l’adresse : HOST et le mot de passe changent à chaque session. Si RTMP ne se connecte pas, essayez SRT et assurez-vous que votre réseau autorise l’UDP sortant sur le port 8890.
L’image saccade ou le son est haché
Utilisez l’adresse SRT et une connexion filaire. Les machines de streaming se trouvent en Chine : depuis les autres continents, RTMP a souvent du mal à suivre, alors que SRT récupère les données perdues dans la limite de la latence définie dans l’adresse.
L’animateur ne répond pas à un message
L’animateur répond à un message à la fois : dans un chat très actif, la plupart des messages sont donc ignorés. Un message est également ignoré s’il contient des mots bloqués ou si la requête a reçu une réponse 429.
Quel est le retard du flux ?
L’animateur commence à parler quelques secondes après l’arrivée d’un message. Récupérer et rediffuser le flux ajoute quelques secondes de plus, et la plateforme ajoute son propre délai : sur une plateforme, les spectateurs entendent donc la réponse nettement plus tard que dans le salon de ce site.