file_pull

Loop or play once from an HTTP(S) URL. Supported containers include MP4, MOV, WebM, MKV, MP3, and OGG.

Example

curl -X POST "https://api.avflow.dev/v1/jobs" \
  -H "Authorization: Bearer ${AVFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "vod-filler",
    "sources": [{
      "name": "promo",
      "type": "file_pull",
      "config": {
        "url": "https://cdn.example.com/promo.mp4",
        "loop": true,
        "headers": { "Authorization": "Bearer <token>" }
      }
    }],
    "nodes": [],
    "sinks": [{
      "name": "out",
      "type": "rtmp_push",
      "inputs": ["promo"],
      "config": { "urls": ["rtmp://live.example.com/app/key"] }
    }]
  }'

Config

Field	Type	Default	Description
url	string	—	HTTP(S) file URL (server must support Range requests)
identity	string	source name	Speaker label for downstream attribution
headers	map	—	Auth headers
loop	bool	false	Restart from beginning on EOF
startTimeoutMs	int	30000	Timeout waiting for first frame
stallTimeoutMs	int	0	Abort if no new frames for N ms (0 = off)

Supported formats

Container	Video	Audio
MP4 / MOV / M4A	H.264, H.265, AV1	AAC
WebM / MKV	VP8, VP9, AV1, H.264, H.265	Opus, Vorbis, AAC
MP3 / OGG	—	MPEG audio, Opus, Vorbis

Pricing

Video/audio tier by actual decoded resolution. Source pricing.