For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Register a media URL as a reusable asset and get back its id. Use the id in generation inputs (input[].assetId) or as a voice clone sample. To upload a local file, first request a presigned URL via POST /v2/assets/upload, PUT the file there, then register the returned url here. Registration verifies the upload happened and enforces plan limits on the actual file size.
projectId is optional. When provided it must reference a project in your organization — a stale or foreign id is rejected with a 422 and errorCode project_not_found; omit the field if you don’t need the asset attached to a project.
Authentifizierung
x-api-keystring
API-Key-Authentifizierung via Header
Anfrage
This endpoint expects an object.
urlstringErforderlich
The public URL of the media to register — e.g. the url returned by POST /v2/assets/upload. Registration verifies the upload happened and enforces plan limits on the actual file size.
typeenumErforderlich
The type of asset.
Erlaubte Werte:
namestringOptional
An optional display name for the asset.
visibilityenumOptionalStandardwert ist USER
Who can see the asset. Defaults to USER.
Erlaubte Werte:
projectIdstringOptional
Optionally attach the asset to a project (created via POST /v2/projects) so it appears in Studio under that project's media. Must reference a project in your organization — otherwise the request is rejected with 422.
inputTypeenumOptional
The source of the asset.
thumbnailUrlstring or nullOptional
Optional thumbnail URL for the asset.
sizelongOptional
File size in bytes.
formatstringOptional
File format or extension.
durationSecondsdoubleOptional
Media duration in seconds.
widthintegerOptional
Width in pixels for video or image assets.
heightintegerOptional
Height in pixels for video or image assets.
Antwort
Asset registered successfully
idstring
A unique identifier for an asset.
createdAtdatetime
The date and time the asset was created.
updatedAtdatetime
The date and time the asset was last updated.
typeenum
The type of asset file.
Erlaubte Werte:
visibilityenum
Visibility scope for the asset.
Erlaubte Werte:
namestringOptional
The filename of the asset.
urlstringOptional
The URL to access the asset media.
sizelongOptional
File size in bytes.
formatstringOptional
File format/extension (e.g., "mp4", "wav").
inputTypeenumOptional
The source type of the asset.
durationSecondsdoubleOptional
Duration of the media in seconds (for audio/video).
thumbnailUrlstringOptional
URL to the asset's thumbnail image.
widthintegerOptional
Width in pixels (for video/image).
heightintegerOptional
Height in pixels (for video/image).
projectIdstringOptional
The id of the project this asset is attached to, or null when it belongs to no project.
proxyPathstring or nullOptional
Stable API proxy path for authenticated media playback.
