file_pull

Loop or play once from a network URL with an explicit protocol. 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"],
        "encoding": { "videoCodec": "h264", "audioCodec": "aac" }
      }
    }]
  }'

Config

Field	Type	Default	Description
url	string	—	Network file URL with protocol (for example https://...); local paths and file:// are not allowed
identity	string	source name	Speaker label for downstream attribution
displayName	string	identity / source name	Human-readable label for overlays and captions
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.