Skip to content
SayGMDocs
Dashboard

Download video content

GET
/videos/{id}/content
curl --request GET \
--url 'https://api.saygm.com/v1/videos/example/content?variant=video' \
--header 'Authorization: Bearer <token>'

Download completed video content as MP4. Content is available until the job’s expires_at time; after expiry this endpoint returns HTTP 410 with error.code video_content_expired. A job response marks an expired artifact with status failed and error code expired.

id
required
string
variant
string
Allowed values: video

The only accepted value is video; this is also the default when omitted.

The MP4 video file.

Media typevideo/mp4
string format: binary
Content-Disposition
string
Cache-Control
string

The API key is missing or invalid.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The job was not found for this account.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The video is not ready or generation failed.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The video content has expired. error.code is video_content_expired.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

Byte range requests are not supported.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The video content could not be delivered.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The service cannot complete the request right now.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}