> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Video models (Beta)

> List active public video model capabilities.

Each item includes capability metadata such as:

* `model`
* `name`
* `status`
* `input_types`
* `output_types`
* `supported_params`
* `supported_parameters`
* `supported_params_detail`
* `supported_parameters_detail`
* `providers`, each with provider-level supported parameter detail
* `pricing`

`supported_parameters` is the OpenRouter-compatible alias for `supported_params`. `supported_params_detail` and `supported_parameters_detail` are aliases for the same structured metadata. New clients should prefer `supported_parameters` and `supported_parameters_detail`; existing clients can continue reading `supported_params` and `supported_params_detail`.

These detail maps expose structured constraints such as allowed durations, resolutions, qualities, aspect ratios, voice or audio options when relevant, and provider-specific parameter support when that metadata is available.

You can filter models by supported parameter with the `params` query parameter. Repeat it or pass a comma-separated list. The filter accepts canonical names and aliases from `supported_parameters_detail`, so `params=size` can match models whose canonical parameter is `resolution`, and `params=duration_seconds` can match `duration`.

```bash theme={null}
curl "https://api.phaseo.ai/v1/videos/models?params=size,duration_seconds" \
  -H "Authorization: Bearer $PHASEO_API_KEY"
```

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "model": "openai/sora",
      "status": "active",
      "input_types": ["text", "image"],
      "output_types": ["video"],
      "supported_params": ["duration", "resolution", "aspect_ratio"],
      "supported_parameters": ["duration", "resolution", "aspect_ratio"],
      "supported_parameters_detail": {
        "duration": {
          "supported": true,
          "values": [4, 8, 12],
          "providers": ["openai"]
        },
        "resolution": {
          "supported": true,
          "values": ["720p", "1080p"],
          "providers": ["openai"]
        }
      },
      "providers": [
        {
          "id": "openai",
          "supported_params": ["duration", "resolution", "aspect_ratio"],
          "supported_parameters": ["duration", "resolution", "aspect_ratio"],
          "supported_parameters_detail": {
            "duration": {
              "supported": true,
              "values": [4, 8, 12]
            }
          }
        }
      ]
    }
  ]
}
```


## OpenAPI

````yaml GET /videos/models
openapi: 3.0.3
info:
  title: Phaseo Gateway API
  description: >-
    A gateway API for accessing various AI models with OpenAI-compatible
    endpoints.
  version: 1.0.0
  contact:
    name: Phaseo
    url: https://phaseo.app
    email: danielbutler500@gmail.com
servers:
  - url: https://api.phaseo.ai/v1
security:
  - BearerAuth: []
tags:
  - name: Gateway
    description: Core Phaseo Gateway operations.
paths:
  /videos/models:
    get:
      tags:
        - Gateway
      summary: List video model capabilities
      description: >-
        Returns DB-backed video model/provider capability metadata for the video
        playground and SDK validation.
      operationId: listVideoModels
      parameters:
        - name: params
          in: query
          required: false
          description: >-
            Optional supported-parameter filter. Repeat the parameter or pass a
            comma-separated list. Canonical names and aliases are accepted, for
            example `resolution`, `size`, `duration`, or `duration_seconds`.
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
      responses:
        '200':
          description: Video model capability list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoModelsResponse'
components:
  schemas:
    VideoModelsResponse:
      type: object
      properties:
        object:
          type: string
          example: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/VideoModelCapability'
    VideoModelCapability:
      type: object
      properties:
        model:
          type: string
        name:
          type: string
        status:
          type: string
        input_types:
          type: array
          items:
            type: string
        output_types:
          type: array
          items:
            type: string
        supported_params:
          type: array
          items:
            type: string
        supported_parameters:
          type: array
          description: OpenRouter-compatible alias for supported_params.
          items:
            type: string
        supported_params_detail:
          $ref: '#/components/schemas/SupportedParameterDetails'
        supported_parameters_detail:
          $ref: '#/components/schemas/SupportedParameterDetails'
        providers:
          type: array
          items:
            $ref: '#/components/schemas/VideoModelProviderCapability'
        pricing:
          type: object
          additionalProperties: true
    SupportedParameterDetails:
      type: object
      description: >-
        Structured constraints and provider support for request parameters,
        keyed by parameter name.
      additionalProperties:
        type: object
        additionalProperties: true
    VideoModelProviderCapability:
      type: object
      properties:
        id:
          type: string
        supported_params:
          type: array
          items:
            type: string
        supported_parameters:
          type: array
          description: OpenRouter-compatible alias for supported_params.
          items:
            type: string
        supported_params_detail:
          $ref: '#/components/schemas/SupportedParameterDetails'
        supported_parameters_detail:
          $ref: '#/components/schemas/SupportedParameterDetails'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication

````