Video from Image

Generate video clips from a reference image. Provide a starting frame (and optionally an end frame) along with a motion prompt, and the model will animate the scene.

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`	Duration (s)
Veo 3	`video_from_image`	`"veo-3"`	4, 6, 8
Veo 3 Fast	`video_from_image`	`"veo-3-fast"`	4, 6, 8
Veo 3.1	`video_from_image`	`"veo-3.1"`	4, 6, 8
Veo 3.1 Fast	`video_from_image`	`"veo-3.1-fast"`	4, 6, 8
Veo 3.1 Lite	`video_from_image`	`"veo-3.1-lite"`	4, 6, 8
Gemini Omni Flash	`video_from_image`	`"gemini-omni-flash-preview"`	1–10
Kling v3	`video_from_image`	`"kling-v3"`	—
Kling v2.6	`video_from_image`	`"kling-v2-6"`	—
Kling v2.1	`video_from_image`	`"kling-v2-1"`	—
Kling v1.6	`video_from_image`	`"kling-v1-6"`	—
Seedance Lite (legacy alias)	`video_from_image`	`"seedance-lite"`	3–12
Seedance Pro (legacy alias)	`video_from_image`	`"seedance-pro"`	3–12
Seedance 1.0 Lite	`video_from_image`	`"seedance-1.0-lite"`	3–12
Seedance 1.0 Pro	`video_from_image`	`"seedance-1.0-pro"`	3–12
Seedance 1.5 Pro	`video_from_image`	`"seedance-1.5-pro"`	3–12
Seedance 2.0	`video_from_image`	`"seedance-2.0"`	4–15
Seedance 2.5	`video_from_image`	`"seedance-2.5"`	4–15
Grok	`video_from_image`	`"grok"`	1–15

Request body

Field	Type	Required	Description
`generation_type`	string	Yes	`"video_from_image"`.
`data.image_resource_id`	string	Yes	Starting frame image content resource ID.
`data.image_tail_resource_id`	string	No	Optional end frame image content resource ID.
`data.prompt`	string	No	Text description of the desired motion or scene. 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. Accepted values depend on the model — see the Duration column in Models.
`data.native_audio`	boolean	No	Request native audio when supported by the selected video model. Defaults to `false` when omitted.
`data.image_var`	string	No	Variable name to map the image value from a column.
`data.image_tail_var`	string	No	Variable name to map the end frame image from a column.
`data.prompt_var`	string	No	Variable name to map the prompt from a column.
`data.negative_prompt_var`	string	No	Variable name to map the negative prompt from a column.

Response (201)

{
  "generation_id": 9030,
  "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/3200/generate?agent_id=42" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "generation_type": "video_from_image",
    "data": {
      "image_resource_id": "image_res_123",
      "prompt": "Camera slowly zooms in while the product rotates, soft studio lighting",
      "negative_prompt": "blurry, distorted, text overlay",
      "model": "kling-v2-6",
      "aspect_ratio": "9:16",
      "resolution": "1080p",
      "native_audio": false,
      "duration": 5
    }
  }'

Completed generation

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

Cell configuration

Field	Type	Description
`model`	string	Default model: one of `"veo-3"`, `"veo-3-fast"`, `"veo-3.1"`, `"veo-3.1-fast"`, `"veo-3.1-lite"`, `"gemini-omni-flash-preview"`, `"kling-v3"`, `"kling-v2-6"`, `"kling-v2-1"`, `"kling-v1-6"`, `"seedance-lite"`, `"seedance-pro"`, `"seedance-1.0-lite"`, `"seedance-1.0-pro"`, `"seedance-1.5-pro"`, `"seedance-2.0"`, `"seedance-2.5"`, `"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.