PineRouterDocs
GuidesModelsAPI referenceApps

Video

Start a video, then check on it until it is ready.

Video takes from seconds to minutes, so you start a job and check on it.

Start

curl https://pinerouter.ai/v1/videos \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine/text-to-video", "prompt": "A paper boat drifting on a calm lake at sunrise", "seconds": 6, "size": "1280x720"}'

The answer has an id and status.

FieldMeaning
modelModel id from the Models page
promptWhat happens in the video
secondsLength; rounded to the nearest length the model offers
sizeWIDTHxHEIGHT; mapped to the model's aspect ratio and resolution
input_referenceLink to a start image, for image-to-video models

Check

curl https://pinerouter.ai/v1/videos/$VIDEO_ID -H "Authorization: Bearer $API_KEY"

Poll every 5 to 10 seconds until status is completed (with the video link) or failed. A failed video is not charged.

Every setting of a model (keyframes, camera, audio, quality tiers) is available through Jobs.

Outputs are AI-generated and keep the labels the model adds (C2PA metadata, watermarks). See AI-generated content.

On this page