Video from Ingredients

Generate video by combining a text prompt with uploaded images (products, logos, reference shots). Reference the images in the prompt and pass their public URLs in images.

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.

Model

Model	`generation_type`
Pika	`video_from_ingredients`

The job runs on Pika; there is no model field. For Grok, Kling, Seedance or Veo use Video from Image or Video from Text.

Request body

Field	Type	Required	Description
`generation_type`	string	Yes	`"video_from_ingredients"`.
`data.prompt`	string	Yes	Text description (1–4000 characters) that references the uploaded images. Supports `{{variable_name}}` syntax.
`data.images`	array	Yes	One or more `{ "value": "<public image URL>" }` objects.
`data.native_audio`	boolean	No	Request native audio. Defaults to `false`.
`data.prompt_var`	object	No	Variable mapping for the prompt.

No other fields are accepted.

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 featuring the uploaded product image, camera orbiting around it with particle effects and dramatic lighting",
      "images": [
        { "value": "https://cdn.gen.pro/uploads/product-front.png" },
        { "value": "https://cdn.gen.pro/uploads/product-side.png" }
      ],
      "native_audio": false
    }
  }'

Completed generation

{
  "id": 9040,
  "status": "completed",
  "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"
    }
  ]
}

Cell configuration

Field	Type	Description
`autoGenerate`	boolean	Auto-trigger generation when dependent variables change.