POST
/
v1
/
avatars
/
create_avatar

Authorizations

ganos-api-key
string
headerrequired

Use the API key generated from our website to programmatically interact with our endpoints. This key authorizes your requests, allowing you to access and utilize our services securely.

Body

application/json
base_video_url
string
required

Publicly accessible and downloadable video url with content type video/mp4 and the maximum size of 300 MB.

title
string | null
webhook_data
object | null

This endpoint allows you to register a webhook, which can be used to get the generation state of the avatar.

Response

200 - application/json
avatar_id
string
required

Unique identifier for the avatar

title
string | null
thumbnail
string | null

Represents the CloudFront URL of the thumbnail, initially null while being generated, and returns the URL once available

status
enum<string> | null
Available options:
consent_pending,
processing,
consent_failed,
failed,
published,
deleted
base_video
string | null

Cloudfront url of the base video.

avatar_webhook
object | null

This endpoint allows you to register a webhook, which can be used to get the generation state of the avatar.

created_at
string | null

ISO 8601 formatted timestamp.