Assistant

Start an assistant chat

Creates a new project and sends the first message to the VideoGen AI assistant, exactly like typing into the assistant on a new project in the app. Asynchronous: the response contains the messageId of the assistant's pending reply (e.g. vg_mesg_...). Poll GET /v1/assistant-messages/{messageId} until status is succeeded, failed, or cancelled, or subscribe to assistant_message.* webhooks. Fetch the parent assistant with GET /v1/assistants/{assistantId} to list all messages in the chat.

post/v1/assistants

Request body

messagestring required

The first message to send to the assistant, exactly as a person would type it into the assistant on a new project.

autoGenerateboolean

When true, the assistant picks the best workflow for the message and immediately starts generating, skipping the suggestion step. When the assistant message reaches succeeded, its generation carries the workflow run to poll.

Example request

{
  "message": "A 30-second explainer about our new pricing tiers"
}

Response

Assistant message accepted.

messageIdstring required

Opaque assistant message id for the pending assistant reply (e.g. vg_mesg_...). Poll GET /v1/assistant-messages/{messageId}.

assistantIdstring required

Opaque assistant chat id (e.g. vg_asst_...). Pass to GET /v1/assistants/{assistantId} and follow-up message/action calls.

projectIdstring required

Opaque project id for the new chat (e.g. vg_proj_...).

projectUrlstring uri required

Deep link to open this project in the VideoGen web app.

Changes

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