Skip to main content
GET
/
videos
/
models
List the available video engines
curl --request GET \
  --url https://api.samsa.ai/public/v1/videos/models \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "modes": [
        "<string>"
      ],
      "supports_end_frame": true,
      "durations": [
        123
      ],
      "resolutions": [
        "<string>"
      ],
      "aspect_ratios": [
        "<string>"
      ],
      "supports_audio": true,
      "credits_per_second": 123,
      "durations_by_resolution": {
        "1080p": [
          8
        ]
      },
      "durations_with_end_frame": [
        8
      ],
      "default_resolution": "1080p",
      "resolution_multipliers": {
        "1080p": 2,
        "720p": 1
      },
      "audio_credit_multiplier": 1.67
    }
  ]
}
Returns the catalog of available video engines. Each entry lists the modes it supports, valid durations (and durations_by_resolution / durations_with_end_frame where they differ), resolutions, aspect_ratios, whether it supports an end frame or audio, and its credit pricing (credits_per_second, resolution_multipliers, audio_credit_multiplier). Read this endpoint before calling POST /videos/generations so you pass a valid engine + duration + resolution combination — unsupported values return 422.

Authorizations

​
Authorization
string
header
required

Organization API key as a bearer token: Authorization: Bearer samsa_sk_....

Headers

​
authorization
string | null

Response

Successful Response

GET /videos/models response — the public video engine catalog.

​
data
PublicVideoEngine · object[]
required