POST /v1/videos/stream when your application should start receiving video before the complete clip is rendered. The request body matches POST /v1/videos, but the response body is a fragmented-MP4 byte stream.
Streaming changes delivery, not the interaction model. Higgs Avatar generates a video from supplied image and audio or text; it does not create a persistent conversational session.
How streaming works
- Video fragments arrive as they are generated.
- The video ID is returned in the
X-Video-Idresponse header. - The complete MP4 is stored, so it can still be downloaded later from
GET /v1/videos/{video_id}/content. - Browsers can append fragments to a Media Source Extensions
SourceBuffer.
Stream to a file
Streaming is working when response bytes begin arriving before generation completes and the resulting
out.mp4 opens successfully.Play fragments in a browser
Use the Media Source Extensions API to append incoming fragmented-MP4 chunks to aSourceBuffer. Your application should also handle network interruption, buffer backpressure, and unsupported codecs.
Choose an input
Use the same audio-driven or text-driven body with the streaming endpoint.
Streaming endpoint reference
Look up the endpoint contract and response details.