VideoGen API

Create a new actor or visual style. Attach reference images with POST /v1/entities/{entityId}/references.

AuthorizationBearer

API key from app.videogen.io/developers. The full key is only shown once when you create it.

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

This endpoint expects an object.

entityTypeenumRequired

ACTOR features a consistent character; PRODUCT features a consistent product or object; VISUAL_STYLE guides the look of generated images.

namestringRequired

Display name.

descriptionstringOptional

Optional description.

The created entity

entityIdstring

The entity id (e.g. vg_enti_...).

entityTypeenum

ACTOR features a consistent character; PRODUCT features a consistent product or object; VISUAL_STYLE guides the look of generated images.

namestring

Display name.

descriptionstring

Optional description. Empty string when not set.

referenceslist of objects

Reference images attached to the entity.

createdAtinteger

Seconds since epoch (Unix timestamp) when the entity was created.

updatedAtinteger

Seconds since epoch (Unix timestamp) when the entity was last updated.

actorConfigobject or null

Voice and presenter summary for ACTOR entities. Null for VISUAL_STYLE entities.

$	curl -X POST https://api.videogen.io/v1/entities \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"entityType": "VISUAL_STYLE",
>	"name": "Pastel watercolor",
>	"description": "Soft pastel watercolor look for lifestyle clips."
>	}'

1	{
2	"entityId": "vg_enti_f6e5d4c3b2a1",
3	"entityType": "VISUAL_STYLE",
4	"name": "Pastel watercolor",
5	"description": "Soft pastel watercolor look for lifestyle clips.",
6	"references": [],
7	"createdAt": 1779268500,
8	"updatedAt": 1779268500,
9	"actorConfig": null
10	}