Skip to content
SayGMDocs
Dashboard

Retrieve a video job

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

Return the current status and metadata for a video job.

id
required
string

The video job.

Media typeapplication/json
object
id
required
string
object
required
string
Allowed value: video
model
required
string
seconds
required

Requested duration in seconds, serialized as a numeric string.

string
size
required
string
created_at
required

Creation time as Unix seconds.

integer
completed_at
required

Completion time as Unix seconds, or null until complete.

integer | null
expires_at
required

Content expiry time as Unix seconds.

integer
status
required
string
Allowed values: queued in_progress completed failed
error
required
Any of:
object
code
required
string
message
required
string
key
additional properties
any
usage
required
Any of:
object
output_video_seconds
required
integer
cost
required

Settled buyer charge in USD.

string
cost_nano_usd
required

The same charge in integer nano-USD.

integer
progress
integer
<= 100
Example
{
"object": "video",
"status": "queued"
}

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 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"
}