Skip to main content
Use 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-Id response 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 a SourceBuffer. 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.