Generate video
generate_videoGenerate a video from a prompt, optionally from a start image. model and prompt are both required by the server (400 without either). With imageUrl the video is image-to-video, starting from that frame. Spends Galatic.AI credits. Returns a job id; poll get_job_status with kind "video".
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>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "generate_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | A video model id from list_models. Required by the server (400 without it). | |
| style | No | Optional style preset applied to the prompt. | |
| prompt | Yes | What the video shows. Required by the server. | |
| context | Yes | Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution." | |
| imageUrl | No | Start frame for image-to-video: an upload_media publicUrl or an image from your library. | |
| settings | No | Model-specific options, passed through to the model. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" — never guess. | |
| resolution | No | Output resolution such as "720p" or "1080p". Not every model accepts every resolution. | |
| aspectRatio | No | Aspect ratio such as "16:9" or "9:16". Not every model accepts every ratio. | |
| conversation_id | No | Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request. |