Text To Video
text_to_videoGenerate video from text prompt.
Creates videos from text descriptions. Returns the generated video URL.
IMPORTANT: Before calling this tool, use get_available_models() to check the model's specifications. Pay special attention to:
limits.max_steps/min_steps: Valid range for steps parameter
limits.max_fps/min_fps: Valid range for fps parameter
defaults: Recommended values for the model
Available models:
Ltx2_5_22B_Dist_INT8: size=512-1344x512-1344, fps=24 (fixed), frames=49-241, w/h rounded down to a multiple of 64, ≤1.03Mpx, side≤1344, aspect≤2, audio2video audio=1-10s, no negative_promptMiniMaxH3_33B_Turbo_INT8: size=512-1344x512-1344, fps=24 (fixed), frames=56-243, w/h rounded down to a multiple of 32, ≤1.03Mpx, side≤1344, refs: ≤3 images, ≤1 video (0.5-2.3s), ≤3 audio (1-10s), ≤3 files total, no negative_promptLtx2_3_22B_Dist_INT8: size=512-1024x512-1024, fps=24 (fixed), frames=49-241, audio2video audio=1-11s, no negative_promptLtxv_13B_0_9_8_Distilled_FP8: steps=1 (fixed), size=256-768x256-768, fps=30 (fixed), frames=30-120veo-3.1(test model): steps=1 (fixed), size=720-1920x720-1920, fps=24 (fixed), frames=97-193, w/h rounded down to a multiple of 8, ≤2.07Mpx, side≤1920, aspect≤1.78, no negative_promptveo-3.1-fast(test model): steps=1 (fixed), size=720-1920x720-1920, fps=24 (fixed), frames=97-193, w/h rounded down to a multiple of 8, ≤2.07Mpx, side≤1920, aspect≤1.78, no negative_promptkling-4(test model): size=720-2520x720-1920, fps=24 (fixed), frames=73-721, w/h rounded down to a multiple of 2, ≤2.72Mpx, aspect≤2.34, no negative_promptseedance-2.5(test model): size=432-2206x432-2206, fps=24 (fixed), frames=97-721, w/h rounded down to a multiple of 2, ≤2.09Mpx, side≤2206, aspect≤2.34, refs: ≤9 images, ≤1 video (1.8-30.2s), ≤3 audio (1.8-30.2s), ≤12 files total, no negative_prompt Models marked (test model) are experimental: they may change or disappear. Prefer an unmarked model unless the caller asks for one of them.
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": {
"prompt": "<prompt>",
"model": "<model>"
},
"name": "text_to_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Frames per second. Defaults to the model's own value (see the model list); most models fix it | |
| seed | No | Random seed for reproducibility | |
| model | Yes | Video generation model name | |
| steps | No | Number of inference steps. Defaults to the model's own value (see the model list); ignored by models that do not support steps | |
| width | No | Video width in pixels. Defaults to the model's own value (see the model list) | |
| frames | No | Number of video frames. Defaults to the model's own value (see the model list); each model has its own range | |
| height | No | Video height in pixels. Defaults to the model's own value (see the model list) | |
| prompt | Yes | Text prompt for video generation | |
| webhook_url | No | HTTPS URL for deAPI to call when this job finishes. Notifies your own systems; the tool still returns the result here | |
| enhance_prompt | No | Let the API rewrite the prompt before generating. Only on models with a prompt-booster guide (422 otherwise); its fee is charged on the job and is not in the /price quote | |
| guidance_scale | No | Guidance scale. Leave unset to use the model's own default; no model in the catalogue currently supports guidance | |
| webhook_secret | No | 32-255 char key deAPI signs the callback with (HMAC-SHA256). Needs webhook_url. A secret given in chat stays in the transcript | |
| negative_prompt | No | Things to exclude (optional) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||