Video from Text

Generate video clips from text prompts. Choose from multiple models depending on your quality, speed, and style requirements.

Endpoint

POST /v1/vidsheet/{id}/cells/{cell_id}/generate?agent_id={agent_id}

Path parameters

Parameter	Type	Description
`id`	integer	The sheet ID.
`cell_id`	integer	The cell ID.

Query parameters

Parameter	Type	Description
`agent_id`	integer	The agent ID.

Models

Model	`generation_type`	`data.model`
Veo 3	`video_from_text`	`"veo_3"`
Veo 3 Fast	`video_from_text`	`"veo_3_fast"`
Veo 3.1	`video_from_text`	`"veo_3_1"`
Veo 3.1 Fast	`video_from_text`	`"veo_3_1_fast"`
Sora 2	`video_from_text`	`"sora_2"`
Kling 1.6	`video_from_text`	`"kling_1_6"`
Seedance Pro	`video_from_text`	`"seedance_pro"`
Seedance Pro 1.5	`video_from_text`	`"seedance_pro_1_5"`
Grok	`video_from_text`	`"grok"`

Request body

Field	Type	Required	Description
`generation_type`	string	Yes	`"video_from_text"`.
`data.prompt`	string	Yes	Text description of the video to generate. Supports `{{variable_name}}` syntax.
`data.negative_prompt`	string	No	What to avoid in the generated video.
`data.model`	string	No	Model variant. See Models table.
`data.aspect_ratio`	string	No	`"1:1"`, `"9:16"`, or `"16:9"`. Grok also supports `"4:3"`, `"3:4"`, `"3:2"`, and `"2:3"`.
`data.resolution`	string	No	Output resolution. Use `"1080p"` or `"720p"` when supported by the selected model. If omitted, the API uses the cell default or the closest supported model default.
`data.duration`	integer	No	Video duration in seconds.
`data.native_audio`	boolean	No	Request native audio when supported by the selected video model. Defaults to `false` when omitted.
`data.prompt_var`	string	No	Variable name to map the prompt value from a column.
`data.negative_prompt_var`	string	No	Variable name to map the negative prompt from a column.

Response (201)

{
  "generation_id": 9020,
  "status": "pending"
}

Once complete, the generated video is available in output_resources. Poll with GET /v1/generations/{generation_id} to check status.

Example

curl -X POST "https://api.gen.pro/v1/vidsheet/101/cells/3100/generate?agent_id=42" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "generation_type": "video_from_text",
    "data": {
      "prompt": "A drone shot flying over a tropical beach at golden hour, waves gently crashing on white sand, cinematic",
      "negative_prompt": "text, watermark, blurry, low quality",
      "model": "veo_3",
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "native_audio": false,
      "duration": 10
    }
  }'

Completed generation

{
  "id": 9020,
  "status": "completed",
  "user_job_type": "video_generation",
  "result": null,
  "failed_reason": null,
  "output_resources": [
    {
      "id": 1700,
      "url": "https://cdn.gen.pro/outputs/vid_001.mp4",
      "thumbnail_url": "https://cdn.gen.pro/thumbnails/vid_001.jpg",
      "object_type": "video",
      "type": "output"
    }
  ],
  "execution_cost": 5.0
}

Cell configuration

Field	Type	Description
`model`	string	Default model: `"veo_3"`, `"veo_3_fast"`, `"veo_3_1"`, `"veo_3_1_fast"`, `"sora_2"`, `"kling_1_6"`, `"seedance_pro"`, `"seedance_pro_1_5"`, or `"grok"`.
`ratio`	string	Default aspect ratio: `"1:1"`, `"9:16"`, `"16:9"`. Grok also supports `"4:3"`, `"3:4"`, `"3:2"`, and `"2:3"`.
`resolution`	string	Default output resolution for supported video models: `"1080p"` or `"720p"`.
`duration`	number	Default duration in seconds.
`autoGenerate`	boolean	Auto-trigger generation when dependent variables change.