create_analysis_batch
Run 2-10 prompts on the same video in a single API call to save cost and time. Retrieve all analysis results and pricing summary together.
Instructions
Run 2–10 prompts against the SAME video in one call (POST /v1/analyses/batch). Pricing: the first prompt is billed at full price, each additional prompt at 50% — always cheaper than separate create_analysis calls for multi-question workloads. Returns an analysis_batch with every analysis resource plus a pricing summary; poll each analysis id individually with get_analysis or wait_for_analysis. To check assessability of individual prompts first, use validate_analysis (free).
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": {
"video_id": "<video_id>",
"prompts": "<prompts>"
},
"name": "create_analysis_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model id (see list_models). Defaults to the current default model. | |
| prompts | Yes | 2–10 free-text prompts. First is full price; each additional is billed at 50%. | |
| metadata | No | Optional key-value metadata attached to every analysis in the batch. | |
| video_id | Yes | The video to analyze (video_… id). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| object | Yes | ||
| pricing | Yes | ||
| analyses | Yes | ||
| video_id | Yes |