Assets

Create a HeyGen asset upload (for auto-mode file_asset_ids)

Returns a presigned upload_url + asset_id. PUT your file bytes to upload_url with the returned upload_headers, then call POST /v1/assets/{id}/complete. Use asset_id as an auto-mode file_asset_ids entry, an avatar asset_id, or a brand logo_asset_id.

post/v1/assets

Request

Base URL
https://api.vivideo.ai
Auth
HTTP bearer
TypeScript
https://skmtc.dev/vivideo/apis/vivideo-api/docs/v1/assets/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

filenamestring required

content_typestring required

size_bytesinteger required

Example request

{
  "filename": "reference.png",
  "content_type": "image/png",
  "size_bytes": 20480
}

Response

Asset upload created.

idstring

Our stable asset id (for complete/delete).

objectstring

asset_idstring

HeyGen asset id — use in file_asset_ids / avatar asset_id / brand logo_asset_id.

upload_urlstring

upload_headersobject

status'uploading' | 'processing' | 'ready' | 'deleted'

asset_typestring

urlstring

content_typestring

size_bytesinteger

Example response

{
  "id": "as_1a2b3c4d",
  "object": "asset"
}

Changes

No recorded changes to this operation across all 1 revision of this API.