Skip to main content
Glama

createVideo

Generate a short video clip from a source image and a motion text prompt (image-to-video); a source image is required - to make a video from text alone, first createImage and animate that, or use createVideoFromReferences with reference images. Griffin (default, 480p) and Griffin HD (720p) both generate a soundtrack; no separate audio step is needed. The job result is the video URL and its actual duration in seconds. Optionally pass final_image to interpolate between a start and end frame. The chosen model and duration must be compatible (incompatible combinations return HTTP 400); see the model and duration fields for the values each model accepts. Credits are held when the job is accepted; the final charge is max(rate × produced seconds, the model's minimum charge), never more than for the duration you requested, and the difference (or everything, if the job fails or is cancelled) is refunded. Pass an optional request_id to tag the result so you can locate it later via listGenerations (type video). Related tools: use createImage for static images, animateSprite for sprite-sheet animation, and listGenerations (type video) to list videos you generated earlier. Async generation job: returns {id, status} - poll getApiJob (job and credit contract: see the server instructions).

Credits: credits/s × seconds, per model: Griffin 1.5/s (shortest duration 5s, so 7.5 credits minimum), Griffin HD 2/s (shortest duration 5s, so 10 credits minimum), Blitz 1/s (shortest duration 2s, so 2 credits minimum) [LEGACY], Eagle 1.3/s [LEGACY], Eagle with Audio 1.8/s [LEGACY]; [LEGACY] models are scheduled for removal - do not use them for new work; see this endpoint's full pricing table in the API docs.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
requestBodyYesPayload for generating a video from a source image and motion prompt

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / example
      Previous value: -3New value: +5
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"griffin\" (Griffin): 1.5 credits/s\n- \"griffin-hd\" (Griffin HD): 2 credits/s\n- \"blitz\" (Blitz): 1 credits/s · LEGACY - scheduled for removal, do not use for new work\n- \"eagle\" (Eagle): 1.3 credits/s · LEGACY - scheduled for removal, do not use for new work\n- \"eagle-audio\" (Eagle with Audio): 1.8 credits/s · LEGACY - scheduled for removal, do not use for new work\nLegacy aliases: \"standard\" → blitz.\nModels marked LEGACY still work for existing integrations but will be removed; pick a current model for anything new. Default: \"eagle\"."New value: +"Model to use. Available models:\n- \"griffin\" (Griffin): 1.5 credits/s, shortest duration 5s, so 7.5 credits minimum · Fast cinematic videos in any style, with audio, 480p\n- \"griffin-hd\" (Griffin HD): 2 credits/s, shortest duration 5s, so 10 credits minimum · Same as Griffin, but in 720p\n- \"blitz\" (Blitz): 1 credits/s, shortest duration 2s, so 2 credits minimum · LEGACY - scheduled for removal, do not use for new work\n- \"eagle\" (Eagle): 1.3 credits/s · LEGACY - scheduled for removal, do not use for new work\n- \"eagle-audio\" (Eagle with Audio): 1.8 credits/s · LEGACY - scheduled for removal, do not use for new work\nLegacy aliases: \"standard\" → blitz.\nModels marked LEGACY still work for existing integrations but will be removed; pick a current model for anything new. Default: \"griffin\"."
    • changedInput schema / properties / requestBody / properties / model / example
      Previous value: -"eagle"New value: +"griffin"
    • changedInput schema / properties / requestBody / properties / request_id / description
      Previous value: -"Optional client-provided identifier, unique per request. Re-sending the same request_id returns the existing job instead of generating again. Also usable with the results endpoint."New value: +"Optional client-provided identifier, unique per request. Re-sending the same request_id returns the existing job instead of generating again. Also usable as the request_id filter of listGenerations."
  2. Changed1 schema field changed
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"griffin\" (Griffin): 1.5 credits/s\n- \"griffin-hd\" (Griffin HD): 2 credits/s\n- \"blitz\" (Blitz): 1 credits/s\n- \"eagle\" (Eagle): 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): 1.8 credits/s\nLegacy aliases: \"standard\" → blitz. Default: \"eagle\"."New value: +"Model to use. Available models:\n- \"griffin\" (Griffin): 1.5 credits/s\n- \"griffin-hd\" (Griffin HD): 2 credits/s\n- \"blitz\" (Blitz): 1 credits/s · LEGACY - scheduled for removal, do not use for new work\n- \"eagle\" (Eagle): 1.3 credits/s · LEGACY - scheduled for removal, do not use for new work\n- \"eagle-audio\" (Eagle with Audio): 1.8 credits/s · LEGACY - scheduled for removal, do not use for new work\nLegacy aliases: \"standard\" → blitz.\nModels marked LEGACY still work for existing integrations but will be removed; pick a current model for anything new. Default: \"eagle\"."
  3. Changed3 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Default: 5."New value: +"Duration in seconds. Available values depend on the model:\n- griffin: 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- griffin-hd: 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Default: 5."
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\nLegacy aliases: \"standard\" → blitz. Default: \"eagle\"."New value: +"Model to use. Available models:\n- \"griffin\" (Griffin): 1.5 credits/s\n- \"griffin-hd\" (Griffin HD): 2 credits/s\n- \"blitz\" (Blitz): 1 credits/s\n- \"eagle\" (Eagle): 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): 1.8 credits/s\nLegacy aliases: \"standard\" → blitz. Default: \"eagle\"."
    • changedInput schema / properties / requestBody / properties / model / enum
      Previous value: -[
      -  "blitz",
      -  "standard",
      -  "eagle",
      -  "eagle-audio"
      -]New value: +[
      +  "griffin",
      +  "griffin-hd",
      +  "blitz",
      +  "standard",
      +  "eagle",
      +  "eagle-audio"
      +]
  4. Changed3 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- forge-pixel: 1, 1.5, 2, 2.5, 3, 3.5, 4 Default: 5."New value: +"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Default: 5."
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\n- \"forge-pixel\" (Forge Pixel): 2 credits/s, min 4\nLegacy aliases: \"standard\" → blitz. Default: \"eagle\"."New value: +"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\nLegacy aliases: \"standard\" → blitz. Default: \"eagle\"."
    • changedInput schema / properties / requestBody / properties / model / enum
      Previous value: -[
      -  "blitz",
      -  "standard",
      -  "eagle",
      -  "eagle-audio",
      -  "forge-pixel"
      -]New value: +[
      +  "blitz",
      +  "standard",
      +  "eagle",
      +  "eagle-audio"
      +]
  5. Changed6 schema fields changed
    • removedInput schema / properties / requestBody / properties / augment_prompt / default
      Removed value: -true
    • changedInput schema / properties / requestBody / properties / augment_prompt / description
      Previous value: -"Augment the prompt behind the scenes. Disable to have more control."New value: +"Augment the prompt behind the scenes. Disable to have more control. Default: true."
    • removedInput schema / properties / requestBody / properties / duration / default
      Removed value: -5
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- forge-pixel: 1, 1.5, 2, 2.5, 3, 3.5, 4"New value: +"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- forge-pixel: 1, 1.5, 2, 2.5, 3, 3.5, 4 Default: 5."
    • removedInput schema / properties / requestBody / properties / model / default
      Removed value: -"eagle"
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\n- \"forge-pixel\" (Forge Pixel): 2 credits/s, min 4\nLegacy aliases: \"standard\" → blitz."New value: +"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\n- \"forge-pixel\" (Forge Pixel): 2 credits/s, min 4\nLegacy aliases: \"standard\" → blitz. Default: \"eagle\"."
  6. Changed3 schema fields changed
    • addedInput schema / properties / requestBody / properties / duration / default
      Added value: +5
    • changedInput schema / properties / requestBody / properties / model / default
      Previous value: -"blitz"New value: +"eagle"
    • changedInput schema / properties / requestBody / properties / model / example
      Previous value: -"blitz"New value: +"eagle"
  7. Changed1 schema field changed
    • changedInput schema / properties / requestBody / properties / request_id / description
      Previous value: -"Optional client-provided identifier for this request. Use this to retrieve results later via the results endpoint."New value: +"Optional client-provided identifier, unique per request. Re-sending the same request_id returns the existing job instead of generating again. Also usable with the results endpoint."
  8. Changed3 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15"New value: +"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- forge-pixel: 1, 1.5, 2, 2.5, 3, 3.5, 4"
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\nLegacy aliases: \"standard\" → blitz."New value: +"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\n- \"forge-pixel\" (Forge Pixel): 2 credits/s, min 4\nLegacy aliases: \"standard\" → blitz."
    • changedInput schema / properties / requestBody / properties / model / enum
      Previous value: -[
      -  "blitz",
      -  "standard",
      -  "eagle",
      -  "eagle-audio"
      -]New value: +[
      +  "blitz",
      +  "standard",
      +  "eagle",
      +  "eagle-audio",
      +  "forge-pixel"
      +]
  9. Changed3 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- chaos: 4, 5, 6, 7, 8, 9, 10, 11, 12"New value: +"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15"
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\n- \"chaos\" (Chaos): Visual Quality: 6/10 · Motion Stability: 3/10 · 0.6 credits/s\nLegacy aliases: \"standard\" → blitz, \"new\" → chaos."New value: +"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\nLegacy aliases: \"standard\" → blitz."
    • changedInput schema / properties / requestBody / properties / model / enum
      Previous value: -[
      -  "blitz",
      -  "standard",
      -  "eagle",
      -  "eagle-audio",
      -  "chaos",
      -  "new"
      -]New value: +[
      +  "blitz",
      +  "standard",
      +  "eagle",
      +  "eagle-audio"
      +]
  10. Changed3 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- chaos: 4, 5, 6, 7, 8, 9, 10, 11, 12"New value: +"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- eagle-audio: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- chaos: 4, 5, 6, 7, 8, 9, 10, 11, 12"
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"chaos\" (Chaos): Visual Quality: 6/10 · Motion Stability: 3/10 · 0.6 credits/s\nLegacy aliases: \"standard\" → blitz, \"new\" → chaos."New value: +"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"eagle-audio\" (Eagle with Audio): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.8 credits/s\n- \"chaos\" (Chaos): Visual Quality: 6/10 · Motion Stability: 3/10 · 0.6 credits/s\nLegacy aliases: \"standard\" → blitz, \"new\" → chaos."
    • changedInput schema / properties / requestBody / properties / model / enum
      Previous value: -[
      -  "blitz",
      -  "standard",
      -  "eagle",
      -  "chaos",
      -  "new"
      -]New value: +[
      +  "blitz",
      +  "standard",
      +  "eagle",
      +  "eagle-audio",
      +  "chaos",
      +  "new"
      +]
  11. Changed8 schema fields changed
    • removedInput schema / properties / requestBody / properties / duration / default
      Removed value: -5
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Video duration in seconds Accepted values: 3, 5, 8, 10."New value: +"Duration in seconds. Available values depend on the model:\n- blitz: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12\n- eagle: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15\n- chaos: 4, 5, 6, 7, 8, 9, 10, 11, 12"
    • changedInput schema / properties / requestBody / properties / duration / example
      Previous value: -5New value: +3
    • changedInput schema / properties / requestBody / properties / duration / format
      Previous value: -"integer"New value: +"float"
    • changedInput schema / properties / requestBody / properties / model / default
      Previous value: -"standard"New value: +"blitz"
    • changedInput schema / properties / requestBody / properties / model / description
      Previous value: -"Video generation model to use.\n- \"standard\": More consistent and predictable results\n- \"new\": Higher quality with more dynamic motion"New value: +"Model to use. Available models:\n- \"blitz\" (Blitz): Visual Quality: 4/10 · Motion Stability: 8/10 · 1 credits/s\n- \"eagle\" (Eagle): Visual Quality: 8/10 · Motion Stability: 5/10 · 1.3 credits/s\n- \"chaos\" (Chaos): Visual Quality: 6/10 · Motion Stability: 3/10 · 0.6 credits/s\nLegacy aliases: \"standard\" → blitz, \"new\" → chaos."
    • changedInput schema / properties / requestBody / properties / model / enum
      Previous value: -[
      -  "standard",
      -  "new"
      -]New value: +[
      +  "blitz",
      +  "standard",
      +  "eagle",
      +  "chaos",
      +  "new"
      +]
    • changedInput schema / properties / requestBody / properties / model / example
      Previous value: -"standard"New value: +"blitz"
  12. Changed2 schema fields changed
    • changedInput schema / properties / requestBody / properties / duration / description
      Previous value: -"Video duration in seconds"New value: +"Video duration in seconds Accepted values: 3, 5, 8, 10."
    • removedInput schema / properties / requestBody / properties / duration / enum
      Removed value: -[
      -  3,
      -  5,
      -  8,
      -  10
      -]
  13. Changed1 schema field changed
    • addedInput schema / properties / requestBody / properties / request_id
      Added value: +{
      +  "description": "Optional client-provided identifier for this request. Use this to retrieve results later via the results endpoint.",
      +  "type": "string"
      +}
  14. Added

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full behavioral burden and handles it well: it discloses async job behavior, polling via getApiJob, generation of a soundtrack, credit hold/refund semantics, model/duration compatibility errors, and legacy model removal status. This far exceeds the minimum needed for safe invocation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long, but it is front-loaded with the core purpose and required input, and nearly every sentence carries operational value. It loses a point for density and some overlap with schema-level details, but it remains well-structured and useful.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity — async generation, pricing, compatibility rules, and many sibling tools — the description is remarkably complete. It covers prerequisites, alternatives, return shape, job polling, refund behavior, and result lookup, so an agent has everything needed to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds meaningful semantic context: it explains why model/duration compatibility matters, gives per-model credit costs, notes the effect of optional final_image interpolation, and clarifies request_id's role in locating results via listGenerations. It does not fully re-explain every parameter, but that is acceptable since the schema already covers them.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Generate a short video clip from a source image and a motion text prompt (image-to-video)', and explicitly states that a source image is required. It also differentiates itself from siblings by naming createVideoFromReferences, createImage, and animateSprite as alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit when-to-use guidance: use this tool when you have a source image and motion prompt. It also tells the agent what to do for text-only video ('first createImage and animate that, or use createVideoFromReferences with reference images') and names related tools for static images and sprite animation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.