Video from Ingredients

Generate video by combining a text prompt with uploaded assets (images, clips, logos). Reference your assets in the prompt and pass their IDs via asset_resource_ids.

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`
Pika	`video_from_ingredients`	`"pika"`
Kling 1.6	`video_from_ingredients`	`"kling_1_6"`
Seedance Lite	`video_from_ingredients`	`"seedance_lite"`
Veo 3.1	`video_from_ingredients`	`"veo_3_1"`
Veo 3.1 Fast	`video_from_ingredients`	`"veo_3_1_fast"`
Grok	`video_from_ingredients`	`"grok"`

Request body

Field	Type	Required	Description
`generation_type`	string	Yes	`"video_from_ingredients"`.
`data.prompt`	string	Yes	Text description that references the uploaded assets. Supports `{{variable_name}}` syntax.
`data.asset_resource_ids`	array	Yes	Array of content resource IDs to include in the generation.
`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 from a column.
`data.content_resource_vars`	array	No	Variable names to map content resource IDs from columns.

Response (201)

{
  "generation_id": 9040,
  "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/3300/generate?agent_id=42" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "generation_type": "video_from_ingredients",
    "data": {
      "prompt": "A dynamic product showcase video featuring the uploaded product image, camera orbiting around it with particle effects and dramatic lighting",
      "model": "pika",
      "asset_resource_ids": [501, 502],
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "native_audio": false,
      "duration": 5
    }
  }'

Completed generation

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

Cell configuration

Field	Type	Description
`model`	string	Default model: `"kling_1_6"`, `"seedance_lite"`, `"pika"`, `"veo_3_1"`, `"veo_3_1_fast"`, or `"grok"`.
`ratio`	string	Default aspect ratio.
`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.