REST API ReferenceEndpointsResources

List avatar presenters

List available avatar presenters. Pass an avatarPresenterId from the response to the avatar video endpoint or to a script/slideshow workflow. Pass a reference voiceId to return presenters sorted by best match for that voice. Cursor-paginated; see the Pagination guide.

Authentication

AuthorizationBearer
API key from [app.videogen.io/developers](https://app.videogen.io/developers). The full key is only shown once when you create it.

Query parameters

limitintegerOptional1-200Defaults to 50

Maximum number of items to return in the page. Defaults to 50; capped at 200. See Pagination.

cursorstringOptional

Opaque pagination cursor returned as nextCursor by the previous page. Omit on the first request. Cursors are tied to the endpoint that produced them and must be passed unmodified. See Pagination.

voiceIdstringOptional

Optional reference voice id from GET /v1/resources/tts-voices (e.g. vg_voic_...). When provided, avatar presenters are returned sorted by best match for that voice (best first). Omit to return presenters in the default catalogue order.

Response

List of avatar presenters. Pass an avatarPresenterId to POST /v1/tools/generate-avatar.

avatarPresenterslist of objects
hasMoreboolean

When true, there are more avatar presenters available. Pass nextCursor as the cursor query param to fetch the next page.

nextCursorstring or null

Opaque cursor to fetch the next page. null when hasMore is false.