Create a video
create_videoCreate an AI video. Costs 500 credits for a video, or 100 credits for a product_holder image.
Types:
image_to_video: animate an image (image_url, prompt)
ugc: a spokesperson video from a script (script, voice_id)
product_holder: a person presenting a product (product_image_url)
Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "<type>"
},
"name": "create_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Type of video to create | |
| gender | No | UGC model gender | |
| prompt | No | Animation prompt, required for image_to_video | |
| script | No | UGC script, up to 150 characters | |
| emotion | No | UGC emotion, default neutral | |
| duration | No | Duration in seconds, default 4 | |
| language | No | UGC language, default English | |
| voice_id | No | Voice ID for UGC | |
| image_url | No | CDN URL of the image to animate | |
| resolution | No | Video resolution, default 720p | |
| output_type | No | product_holder output: image costs 100 credits, video costs 500 | |
| aspect_ratio | No | Output aspect ratio | |
| person_prompt | No | Person description for product_holder | |
| wait_for_result | No | Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos. | |
| person_image_url | No | Person image for product_holder | |
| product_image_url | No | Product image, required for product_holder |