Create title and thumbnail options
create_generationMake title and thumbnail options for the user's video: use when they ask for thumbnails, titles or packaging options. Start a durable VoxTale generation from one topic, script, or transcript; for saved material, read it with get_project and pass projectId. Rendered runs need a face choice first (show_face_picker). Omit mode (or use full) for rendered thumbnails; mode concept returns ranked titles, hooks, angles and text thumbnail briefs plus artDirection (composition, typography, color treatment, lighting and background) without rendering images. Both modes consume the same generation allowance. Creates a project unless projectId is supplied; with projectId the niche follows that project's channel. To re-run with adjustments, copy config from get_generation and change what the user asked for. Consumes account allowance once accepted. Use only at the user's request. Supply one unique idempotencyKey and reuse that key and identical input on retries. Returns pending status; poll get_generation. Does not publish to YouTube.
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": {
"idempotencyKey": "<idempotencyKey>",
"material": "<material>"
},
"name": "create_generation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cell | No | ||
| mode | No | full (default) renders thumbnails; concept returns text packaging briefs without image rendering. | |
| style | No | ||
| title | No | ||
| faceless | No | ||
| material | Yes | ||
| pipeline | No | ||
| direction | No | ||
| projectId | No | ||
| refAssetIds | No | ||
| faceAssetIds | No | ||
| patternBreak | No | ||
| idempotencyKey | Yes | ||
| styleRefAssetIds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| error | No | ||
| runId | Yes | ||
| config | No | ||
| status | Yes | ||
| webUrl | Yes | ||
| options | No | ||
| progress | No | ||
| projectId | Yes | ||
| allFlagged | No | ||
| packagingUrl | No | ||
| pollAfterSeconds | No | ||
| artifactExpiresAt | No |