Video Generation

Generate videos with any model available on ImageRouter. Supports both Text-to-Video and Image-to-Video generation. Requests can be encoded as application/json or multipart/form-data (optimal for file uploads).

Curl

# Text-to-Video
curl 'https://api.imagerouter.io/v1/openai/videos/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
--json '{
  "prompt": "YOUR_PROMPT",
  "model": "ir/test-video",
  "size": "auto",
  "seconds": "auto",
  "response_format": "url",
  "image": "https://example.com/your_image.jpg"
}'

Javascript

const url = 'https://api.imagerouter.io/v1/openai/videos/generations'

// Text-to-Video
const payload = {
  prompt: 'YOUR_PROMPT',
  model: 'ir/test-video',
  size: 'auto',
  seconds: 'auto',
  response_format: 'url'
}

// Image-to-Video — pass a URL or data URI string
// payload.image = 'https://example.com/your_image.jpg'

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
})

const data = await response.json()
console.log(data)

Python

import requests

url = "https://api.imagerouter.io/v1/openai/videos/generations"
headers = {
  "Authorization": "Bearer YOUR_API_KEY"
}

# Text-to-Video
payload = {
  "prompt": "YOUR_PROMPT",
  "model": "ir/test-video",
  "size": "auto",
  "seconds": "auto",
  "response_format": "url"
}

# Image-to-Video — pass a URL or data URI string
# payload["image"] = "https://example.com/your_image.jpg"

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Both JSON and Form-Data encoding are accepted

Show Form-Data formatted example

Curl

curl 'https://api.imagerouter.io/v1/openai/videos/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-F 'prompt=YOUR_PROMPT' \
-F 'model=ir/test-video' \
-F 'size=auto' \
-F 'seconds=auto' \
-F 'response_format=url' \
-F 'image[]=@your_image1.webp'

Javascript

const formData = new FormData()
formData.append('prompt', 'YOUR_PROMPT')
formData.append('model', 'ir/test-video')
formData.append('size', 'auto')
formData.append('seconds', 'auto')
formData.append('response_format', 'url')

// Add your image files (up to 16)
const imageFile1 = await fetch('your_image1.webp').then(r => r.blob())
formData.append('image[]', imageFile1)

// or from local file
const imagePath = '/home/phoenics/projects/Image router/materials/logo.png'
const imageBuffer = fs.readFileSync(imagePath)
const imageBlob = new Blob([imageBuffer], { type: 'image/png' })
formData.append('image[]', imageBlob, path.basename(imagePath))

const response = await fetch('https://api.imagerouter.io/v1/openai/videos/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: formData
})

const data = await response.json()
console.log(data)

Python

import requests

url = "https://api.imagerouter.io/v1/openai/videos/generations"
headers = {
  "Authorization": "Bearer YOUR_API_KEY"
}

payload = {
  "prompt": "YOUR_PROMPT",
  "model": "ir/test-video",
  "size": "auto",
  "seconds": "auto",
  "response_format": "url"
}

with open("your_image1.webp", "rb") as img1:
  files = {
      "image[]": img1
  }
  response = requests.post(url, files=files, data=payload, headers=headers)
  print(response.json())

Parameters

• model required Video model to use for generation.

• prompt optional Text input for generating videos. Many models require prompt, but not all.

• size optional Accepted values are different for each model. Some models and providers completely ignore size.

  • auto [default] - Uses the default recommended size for each model.
  • WIDTHxHEIGHT (eg 1024x576)

• seconds optional Duration of the video in seconds. Accepted values vary by model.

  • auto [default] - Uses a default duration for each model.
  • Numeric value (eg 5, 10) - Specific duration in seconds (check model details page for supported values).

• response_format optional

  • url [default] - Returns the video URL hosted on ImageRouter’s servers. The video is saved in your logs. and is publicly accessible with the URL if you share it.
  • b64_json - Returns the video as base64-encoded JSON data. The video is saved in your logs. and is publicly accessible with the URL if you share it.
  • b64_ephemeral - Same as b64_json but the video is not saved in our system. The provider may still have it.

• image / image[] optional Input image for Image-to-Video generation. (Supported models have “image-to-video” label here.) Accepted formats:

  • File upload — multipart/form-data with image[] field
  • URL string — "https://example.com/photo.jpg" (passed as JSON string or form field)
  • Data URI string — "data:image/png;base64,..." (passed as JSON string or form field)

Response

{
  "created": 1769286389027, // timestamp
  "data":[
    {
      "url": "https://storage.imagerouter.io/fffb4426-efbd-4bcc-87d5-47e6936bf0bb.mp4"
      // or "b64_json": "...", if you select a different response_format
    }
  ],
  "latency": 6942,
  "cost": 0.004
}