VIvideogen
Entities

Create entity

Changed on

Create a reusable entity. Attach reference images with POST /v1/entities/{entityId}/references.

post/v1/entities

Request

  • Base URL
    https://api.videogen.io
  • Auth
    HTTP bearer

Request body

entityType'ACTOR' | 'PRODUCT' | 'VISUAL_STYLE' | 'SLIDESHOW_THEME' | 'BRAND' | 'LOCATION' | 'PROP' required

ACTOR features a consistent character; PRODUCT features a consistent product you sell or promote; VISUAL_STYLE guides the look of generated images; SLIDESHOW_THEME is a shared slide design system (fonts, colors, layout) applied to every slide of a slideshow-to-video deck; BRAND holds a logo, a style guide image, and a writing style; LOCATION features a consistent place or set; PROP features a consistent background object that is not a product.

namestring required

Display name.

descriptionstring

Optional description.

Response

The created entity

entityIdstring required

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

entityType'ACTOR' | 'PRODUCT' | 'VISUAL_STYLE' | 'SLIDESHOW_THEME' | 'BRAND' | 'LOCATION' | 'PROP' required

ACTOR features a consistent character; PRODUCT features a consistent product you sell or promote; VISUAL_STYLE guides the look of generated images; SLIDESHOW_THEME is a shared slide design system (fonts, colors, layout) applied to every slide of a slideshow-to-video deck; BRAND holds a logo, a style guide image, and a writing style; LOCATION features a consistent place or set; PROP features a consistent background object that is not a product.

namestring required

Display name.

descriptionstring required

Optional description. Empty string when not set.

createdAtinteger required

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

updatedAtinteger required

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

isBuiltInboolean

When true, this is a VideoGen catalog entity. Built-in entities cannot be updated, archived, or have references added or removed.

Changes

  • 2976ed641a0cRevision changes
    • warning

      added the new BRAND enum value to the response property for the response status

    • warning

      added the new LOCATION enum value to the response property for the response status

    • warning

      added the new PROP enum value to the response property for the response status

    • info

      added the new optional request property

    • info

      added the new BRAND enum value to the request property

    • info

      added the new LOCATION enum value to the request property

    • info

      added the new PROP enum value to the request property

    • info

      added the optional property to the response with the status

    • info

      added the required property // to the response with the status