API Reference

Models

List and retrieve information about available AI video generation models.

GET

/v1/models

Returns a list of all available models that can be used for video generation.

Request

curl -X GET "https://api.vidrouter.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

200

Success

{
  "data": [
    {
      "id": "runway-gen3",
      "name": "Runway Gen-3",
      "description": "Advanced video generation with photorealistic quality",
      "provider": "runway",
      "type": "text-to-video",
      "max_duration": 10,
      "aspect_ratios": ["16:9", "9:16", "1:1"],
      "pricing": {
        "per_second": 0.05
      },
      "capabilities": [
        "text-to-video",
        "image-to-video"
      ]
    },
    {
      "id": "veo-1",
      "name": "Google Veo",
      "description": "Google's state-of-the-art video generation model",
      "provider": "google",
      "type": "text-to-video",
      "max_duration": 5,
      "aspect_ratios": ["16:9", "9:16"],
      "pricing": {
        "per_second": 0.03
      },
      "capabilities": [
        "text-to-video"
      ]
    }
  ],
  "object": "list"
}

Response Fields

Field	Type	Description
id	string	Unique identifier for the model
name	string	Human-readable name of the model
description	string	Brief description of the model's capabilities
provider	string	The company that created the model
type	string	Type of generation (e.g., "text-to-video")
max_duration	number	Maximum video duration in seconds
aspect_ratios	array	Supported aspect ratios
pricing	object	Pricing information
capabilities	array	List of supported generation types

GET

/v1/models/{model_id}

Retrieve detailed information about a specific model.

Path Parameters

Parameter	Type	Description
model_id	string	The ID of the model to retrieve

Request

curl -X GET "https://api.vidrouter.com/v1/models/runway-gen3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

200

Success

{
  "id": "runway-gen3",
  "name": "Runway Gen-3",
  "description": "Advanced video generation with photorealistic quality",
  "provider": "runway",
  "type": "text-to-video",
  "max_duration": 10,
  "aspect_ratios": ["16:9", "9:16", "1:1"],
  "pricing": {
    "per_second": 0.05
  },
  "capabilities": [
    "text-to-video",
    "image-to-video"
  ],
  "object": "model"
}

Tip: Use the models endpoint to discover available models and their capabilities before creating generations. Each model has different strengths, pricing, and limitations.