Skip to main content
GET
/
v3
/
videos
/
models
cURL
curl --request GET \
  --url https://api.opper.ai/v3/videos/models
{
  "limit": 123,
  "models": [
    {
      "capabilities": [
        "<string>"
      ],
      "context_window": 123,
      "cost": 123,
      "description": "<string>",
      "id": "<string>",
      "model_id": "<string>",
      "name": "<string>",
      "provider": "<string>",
      "provider_display_name": "<string>",
      "quality": "<string>",
      "speed": "<string>",
      "type": "<string>",
      "aliases": [
        "<string>"
      ],
      "api_type": "<string>",
      "benchmarks": {
        "as_of": "<string>",
        "source": "<string>",
        "aa_slug": "<string>",
        "coding_index": 123,
        "evaluations": {
          "aime": 123,
          "aime_25": 123,
          "gpqa": 123,
          "hle": 123,
          "ifbench": 123,
          "lcr": 123,
          "livecodebench": 123,
          "math_500": 123,
          "mmlu_pro": 123,
          "scicode": 123,
          "tau2": 123,
          "terminalbench_hard": 123
        },
        "intelligence_index": 123,
        "math_index": 123
      },
      "country": "<string>",
      "family": "<string>",
      "featured": true,
      "maker": "<string>",
      "max_output_tokens": 123,
      "params": {
        "default_max_tokens": 123,
        "embedding": {
          "dimensions": 123,
          "max_input_tokens": 123,
          "supports_dimensions": true
        },
        "image": {
          "default": "<string>",
          "qualities": [
            "<string>"
          ],
          "sizes": [
            "<string>"
          ],
          "styles": [
            "<string>"
          ]
        },
        "image_edit": {
          "aspect_ratios": [
            "<string>"
          ],
          "default": "<string>"
        },
        "max_tokens": true,
        "realtime": {
          "default_voice": "<string>",
          "input_audio_format": "<string>",
          "input_sample_rate": 123,
          "output_audio_format": "<string>",
          "output_sample_rate": 123,
          "reasoning": {
            "default": "<string>",
            "supported": [
              "<string>"
            ],
            "max_budget": 123,
            "mode": "<string>"
          },
          "sample_rate": 123,
          "supports_tools": true,
          "supports_vad": true,
          "voices": [
            "<string>"
          ]
        },
        "reasoning": {
          "default": "<string>",
          "supported": [
            "<string>"
          ],
          "max_budget": 123,
          "mode": "<string>"
        },
        "stt": {
          "default_language": "<string>",
          "formats": [
            "<string>"
          ],
          "languages": [
            "<string>"
          ]
        },
        "temperature": {
          "default": 123,
          "max": 123,
          "min": 123
        },
        "tts": {
          "default_voice": "<string>",
          "max_length": 123,
          "voices": [
            "<string>"
          ]
        },
        "video": {
          "aspect_ratios": [
            "<string>"
          ],
          "max_duration": 123,
          "max_fps": 123,
          "max_frames": 123,
          "resolutions": [
            "<string>"
          ],
          "speed_modes": [
            "<string>"
          ],
          "supports_seed": true
        }
      },
      "pricing": {
        "input": [
          123
        ],
        "output": [
          123
        ],
        "audio_cached_input": [
          123
        ],
        "audio_input": [
          123
        ],
        "audio_input_per_minute": 123,
        "audio_output": [
          123
        ],
        "audio_output_per_minute": 123,
        "cache_creation": [
          123
        ],
        "cache_creation_1h": [
          123
        ],
        "cached_input": [
          123
        ],
        "google_search_price_per_prompt": 123,
        "google_search_price_per_query": 123,
        "image_cached_input": [
          123
        ],
        "image_input": [
          123
        ],
        "image_prices": {},
        "input_transcription_per_minute": {},
        "openai_code_interpreter_price_per_session": 123,
        "openai_file_search_price_per_call": 123,
        "openai_web_search_price_per_call": 123,
        "price_per_generation": 123,
        "price_per_m_chars": 123,
        "price_per_minute": 123,
        "price_per_page": 123,
        "price_per_second": 123,
        "price_per_second_by_resolution": {},
        "reasoning": [
          123
        ],
        "thresholds": [
          123
        ],
        "web_fetch_price_per_request": 123,
        "web_search_price_per_request": 123
      },
      "region": "<string>",
      "retired_at": "2023-11-07T05:31:56Z",
      "route": {
        "country": "<string>",
        "data_handling": {
          "logging": {
            "default": "<string>",
            "retention_days": 123
          },
          "third_party_access": true,
          "training": {
            "default": "<string>"
          },
          "zdr": {
            "status": "<string>"
          }
        },
        "gdpr": {
          "dpa_available": true,
          "residency": "<string>",
          "transfer_mechanism": "<string>"
        },
        "id": "<string>",
        "provider": "<string>",
        "provider_display_name": "<string>",
        "region": "<string>",
        "last_verified_at": "<string>",
        "sources": [
          "<string>"
        ],
        "underlying_maker": "<string>"
      },
      "successor": "<string>",
      "thinking": true
    }
  ],
  "offset": 123,
  "total": 123
}
A type=video view of the model catalog, scoped to the models usable with POST /v3/videos. Use it to discover, in one call:
  • which video models exist, per provider
  • each model’s accepted parameters via params.video (aspect_ratios, resolutions, max_duration)
  • input modality via capabilities:
    • video_generation — text-to-video
    • image_to_video — needs a reference image
    • video_editing — video-to-video (needs a source video)
Filter with ?capability=image_to_video (or any capability) and search with ?q=.

Query Parameters

include
string

Comma-separated list of optional fields to attach to each item. Supported: maker (public), route (requires API key), benchmarks (public).

Example:

"maker,benchmarks"

q
string

Free-text search across model ID, name, and description.

provider
string

Filter by provider name (e.g. openai, anthropic).

capability
string[]

Filter by capability (repeatable). Items matching ALL listed capabilities are returned.

deprecated
boolean

Set to true to include retired models in results.

sort
string
default:id

Field to sort by (id, name, provider, type, cost, speed, quality, context_window). Default id.

order
string
default:asc

asc (default) or desc.

offset
integer
default:0

Pagination offset.

Required range: x >= 0
limit
integer
default:50

Page size (max 500).

Required range: 1 <= x <= 500

Response

Successful response

limit
integer
required
models
object[]
required
offset
integer
required
total
integer
required