Video

Generate Video

post

Generates videos from text prompts or images. Supports 18+ models from Google, OpenAI, Kling AI, Runway, and others. Asynchronous generation - poll /getVideoResponse with taskId to retrieve results.

Authorizations

bearerAuth

AuthorizationstringRequired

FastRouter API Key. Get yours at https://fastrouter.ai

Format: Authorization: Bearer YOUR_API_KEY

Body

application/json

modelstring · enumRequired

Video generation model in provider/model format. See documentation for full list of supported models.

Example: google/veo2Possible values:

promptstringRequired

Natural language description of the video scene to generate

Example: A casual street interview on a busy Bengaluru IT park sidewalk in the afternoon

imagestring · uriOptional

URL of an input image for image-to-video generation. Only URLs supported (no base64). Formats: JPG, PNG, JPEG. Aspect ratio must be 1:4 to 4:1. Required for some models.

Example: https://example.com/image.jpg

lengthinteger · enumOptional

Duration of the video in seconds. Supported values vary by model: 4, 5, 6, 8, 10, or 12.

Example: 8Possible values:

secondsinteger · enumOptional

Duration in seconds (used by Sora models). Supported: 4, 8, or 12.

Example: 8Possible values:

resolutionstring · enumOptional

Output video resolution

Example: 1080pPossible values:

aspectRatiostring · enumOptional

Width-to-height ratio of the video frame

Example: 16:9Possible values:

sizestring · enumOptional

Video dimensions (used by Sora models)

Example: 1280x720Possible values:

modestring · enumOptional

Generation style/mode (if supported by model)

Example: stdPossible values:

seedintegerOptional

Random seed for deterministic output (optional; useful for reproducibility)

Example: 42

generateAudiobooleanOptional

Generate audio track for the video (supported by some models)

Example: true

Responses

200

Video generation task queued successfully

application/json

400

Bad Request - Invalid parameters or model

401

Invalid Credentials - Your API key is invalid, disabled, or your OAuth session has expired. Check your credentials.

application/json

429

Rate Limited - You have exceeded your request limits (TPM/RPM). Slow down or increase your limits.

application/json

500

Internal Server Error

post

/videos

HTTPcURLJavaScriptPython

POST /api/v1/videos HTTP/1.1
Host: api.fastrouter.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 363

{
  "model": "google/veo2",
  "length": 8,
  "prompt": "A casual street interview on a busy Bengaluru IT park sidewalk in the afternoon. The interviewer holds a plain, unbranded microphone and asks: Have you heard about FastRouter. It is super cool. Person replies: Yeah I saw it, it's also available with new Grok models and they also support Google Veo2. It's crazy good."
}

Google Veo 2 (Text-to-Video)OpenAI Sora 2 Pro (Text-to-Video)Kling V2.1 (Image-to-Video)Runway Gen-4 TurboPika V2.2 (Text-to-Video)

{
  "chat_id": "fr_123",
  "model": "google/veo2",
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "taskId": "taskabc123",
    "status": "waiting"
  },
  "usage": {
    "chat_id": "fr_123",
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0,
    "user_key_credits_used": 6,
    "credits_used": 6,
    "provider": "google"
  }
}

Retrieve Video Results

post

Retrieves asynchronous video generation results. Poll with taskId from /videos request until status is succeed/completed, then download from provided URL.

Authorizations

bearerAuth

AuthorizationstringRequired

FastRouter API Key. Get yours at https://fastrouter.ai

Format: Authorization: Bearer YOUR_API_KEY

Body

application/json

taskIdstringRequired

The taskId or id returned from the initial /videos request

Example: taskabc123

modelstringRequired

The model used for video generation (must match original request)

Example: google/veo2

Responses

200

Video generation status or completed video

application/json

400

Bad Request - Invalid taskId or model

401

Invalid Credentials - Your API key is invalid, disabled, or your OAuth session has expired. Check your credentials.

application/json

404

Not Found - Invalid taskId or expired result

429

Rate Limited - You have exceeded your request limits (TPM/RPM). Slow down or increase your limits.

application/json

500

Internal Server Error

post

/getVideoResponse

HTTPcURLJavaScriptPython

POST /api/v1/getVideoResponse HTTP/1.1
Host: api.fastrouter.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "taskId": "taskabc123",
  "model": "google/veo2"
}

Poll Veo 2 StatusPoll Sora 2 Pro Status

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "taskId": "taskabc123",
    "generations": [
      {
        "id": "taskabc123",
        "createdDate": "2025-07-15T08:02:27.000Z",
        "updatedDate": "2025-07-15T08:04:34.000Z",
        "status": "succeed",
        "failMsg": "",
        "url": "https://example.com/filename.mp4",
        "mediaType": "video"
      }
    ]
  }
}