Retrieve a video job
GET
/videos/{id}
const url = 'https://api.saygm.com/v1/videos/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Responses
Section titled “Responses”The video job.
Media typeapplication/json
object
id
required
string
object
required
string
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
error
required
usage
required
progress
integer
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
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
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
potentially_charged
boolean
key
additional properties
any
Example
{ "billing_status": "settled"}