AI Video Atlas

Goal: a usable take on the first generation, so fewer paid generations per shot. First review and rewrite the beat list (see brief_review): Atlas parses briefs with rules, so fix non-shots, missing subjects, placeholder lines and generic coverage before writing prompts. If the user names a model or mode, pass it in model/mode (it is kept for every shot unless the docs rule it out). Returns a GUIDANCE PACKAGE, not final prompts: you (the agent) write each full video prompt yourself from it. Per shot: model + mode decision with reasons, the per-model/per-mode prompt structure and tips, 2-3 credited proven example prompts, capabilities/limits/prices with sources, techniques and director rules (practitioner hints at low weight), required assets with image-gen guidance, an 11-section quality checklist, and a starter draft (starting point only, never paste it as-is). If the user names a model or mode, pass it in model/mode (or keep it verbatim in description): Atlas keeps it for every shot unless the vendor docs rule it out, and explains why in user_named. Write each final prompt as flowing, sectioned prose sentences (subject/action, camera/lens/movement, location/light/color, style, audio), never field labels like speaker_id: or Subject:, and without stock filler phrases. Also returns intake (questions to ask the user + stated assumptions) and package_markdown (readable). Plan a multi-shot AI video from a plain description (deterministic, built only from Atlas data; no AI generation). Output is staged: decide (model/mode/clip length/aspect/cost with reasons and capability checks), direct (shot list with per-model prompts), assets (every reference/frame with status needs-generation|user-supplied|approved), image_prompts, and steps, which include a STOP: get the user to approve assets before generating any video. Global directives (same X in every shot, vertical, no text, style) apply to all shots; questions and request wording are never planned as shots; an explicit shot count is honored; clips longer than an endpoint's documented max are split. The description is split into beats (sentences, clauses, and cues like "then", "cut to", "close-up", "wide"). For each beat it returns a shot type; a recommended model endpoint with its current vendor-stated $/s and source; the generation mode to use (t2v, i2v, reference-to-video, start/end frame, v2v, lip sync; only modes the vendor docs confirm) with a one-line reason; image prompts for any input frames, plus a shared character/product reference sheet when shots must match; an adapted prompt built from the best-matching sourced example (credited and linked), an estimated cost (5 s per shot by default), and a how-to workflow when one applies (lip sync, consistent character…). It also returns a total. budget_usd (total) and/or max_per_shot steer it to cheaper supported endpoints; each shot also offers a cheaper alternative with its cost, and the plan says if the budget can't be met. Use this for "plan / storyboard / make me a video of…" requests; use find_shot for a single shot. Before presenting, adapt the wording to the user's voice, context and brand (names, tone, product details), but keep the prices, models, modes, clip lengths and reference tags exactly as returned.

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model the user named (e.g. \"Seedance 2.5\"). Atlas keeps it for every shot unless the vendor docs rule it out, and then says why. Always pass it when the user names one."
    },
    "mode": {
      "type": "string",
      "enum": [
        "text-to-video",
        "image-to-video",
        "reference-to-video",
        "start/end frame",
        "video-to-video"
      ],
      "description": "Generation mode the user named. Kept for every shot unless the model cannot do it."
    },
    "force_plan": {
      "type": "boolean",
      "description": "Return a shot plan even when the request reads as a pricing-only question"
    },
    "description": {
      "type": "string",
      "description": "What the video should show, in plain words. Several beats are fine."
    },
    "budget_usd": {
      "type": "number",
      "description": "Optional total budget in USD."
    },
    "style": {
      "type": "string",
      "description": "Optional look applied to every shot, e.g. \"35mm film, warm grade\" or \"anime\"."
    },
    "max_per_shot": {
      "type": "number",
      "description": "Optional maximum USD per shot."
    },
    "clip_seconds": {
      "type": "number",
      "default": 5,
      "description": "Seconds per shot (default 5)."
    },
    "retries": {
      "type": "number",
      "description": "Optional retry allowance as a cost multiplier (e.g. 1.5 = budget 50% extra generations for rejected takes)."
    }
  },
  "required": [
    "description"
  ]
}

Get to a usable take in as few further generations as possible when a shot came out wrong. Pass the prompt you used, the model, the mode and what went wrong in plain words ("feet sliding", "face drifted", "line cut off", "too glossy", "label morphing"), plus optional frame notes. Returns a diagnosis, specific prompt changes (from Atlas craft fixes and a per-model failure-mode library, credited), a revised prompt, and an escalation ladder: same-model fixes first (prompt, seed/variation, references, duration), then a mode change, then a model switch only as a last resort with the consistency cost stated. Adapt the revised prompt to the user's voice; no generation is run.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The exact prompt you used."
    },
    "model": {
      "type": "string",
      "description": "Model/endpoint used, e.g. \"Seedance 2.5\", \"Veo 3.1 Fast\"."
    },
    "mode": {
      "type": "string",
      "description": "Mode used: text-to-video, image-to-video, reference-to-video, start/end frame, video-to-video, lip sync."
    },
    "issue": {
      "type": "string",
      "description": "What went wrong, in plain words."
    },
    "seconds": {
      "type": "number",
      "description": "Clip length used (helps check spoken-line fit)."
    },
    "frame_url": {
      "type": "string",
      "description": "Optional link to a bad frame (Atlas does not open it; describe it in frame_notes)."
    },
    "frame_notes": {
      "type": "string",
      "description": "Optional: what you see in the bad frames."
    }
  },
  "required": [
    "prompt",
    "issue"
  ]
}

Alias of refine_shot. Fix a generated shot that came out wrong. Pass the prompt you used, the model, the mode and what went wrong in plain words ("feet sliding", "face drifted", "line cut off", "too glossy", "label morphing"), plus optional frame notes. Returns a diagnosis, specific prompt changes (from Atlas craft fixes and a per-model failure-mode library, credited), a revised prompt, and an escalation ladder: same-model fixes first (prompt, seed/variation, references, duration), then a mode change, then a model switch only as a last resort with the consistency cost stated. Adapt the revised prompt to the user's voice; no generation is run.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The exact prompt you used."
    },
    "model": {
      "type": "string",
      "description": "Model/endpoint used, e.g. \"Seedance 2.5\", \"Veo 3.1 Fast\"."
    },
    "mode": {
      "type": "string",
      "description": "Mode used: text-to-video, image-to-video, reference-to-video, start/end frame, video-to-video, lip sync."
    },
    "issue": {
      "type": "string",
      "description": "What went wrong, in plain words."
    },
    "seconds": {
      "type": "number",
      "description": "Clip length used (helps check spoken-line fit)."
    },
    "frame_url": {
      "type": "string",
      "description": "Optional link to a bad frame (Atlas does not open it; describe it in frame_notes)."
    },
    "frame_notes": {
      "type": "string",
      "description": "Optional: what you see in the bad frames."
    }
  },
  "required": [
    "prompt",
    "issue"
  ]
}

Search AI Video Atlas's library of 106 sourced AI video shots (real prompts that creators posted, with the model used, an estimated cost and a link to the original). Use this FIRST when the user describes a shot, scene, style or job ("product ad with a rotating can", "anime fight", "lip sync dialogue", "drone over mountains"). Filters: shot_type (ads, music, shorts, characters, product, cinematic, lipsync, anime), model (e.g. kling, veo, seedance), max_cost_usd (estimated cost of the clip; when the prompt states no length we use a 5-second clip). Returns prompt excerpts; call best_prompt with a slug for the full prompt. Do not use for prices alone (use get_prices) or for tools/workflows (use get_workflow).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the shot should look like or achieve, in plain words."
    },
    "shot_type": {
      "type": "string",
      "enum": [
        "ads",
        "music",
        "shorts",
        "characters",
        "product",
        "cinematic",
        "lipsync",
        "anime"
      ]
    },
    "model": {
      "type": "string",
      "description": "Only shots made with this model family (strict; comparisons that merely include it are excluded), e.g. kling, veo, seedance, hailuo, runway, luma, wan, ltx, sora"
    },
    "max_cost_usd": {
      "type": "number",
      "description": "Max estimated cost per clip in USD"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 5
    }
  },
  "required": [
    "query"
  ]
}

Get the full, sourced prompt that best matches a shot (free text or a slug from find_shot), optionally for a target model. Returns the exact prompt text as the creator posted it, the creator credit and source, the model it was made with, and factual adaptation notes when the target model differs (other Atlas shots on the target model and its current supported price). Atlas never claims how a prompt will perform on a model it was not made with; treat adaptation notes as guidance.

{
  "type": "object",
  "properties": {
    "shot": {
      "type": "string",
      "description": "A slug from find_shot or a plain description of the shot."
    },
    "model": {
      "type": "string",
      "description": "Target model family (optional)."
    }
  },
  "required": [
    "shot"
  ]
}

Recommend which AI video model to use for a shot, with the evidence: how many sourced Atlas shots of that kind were made with each model, the cheapest supported vendor-stated $/s, and an estimated total for the clip length and number of clips. Pass budget_usd (total) and/or max_per_shot to drop models whose estimate exceeds it; over-budget models are listed with their cost. Each row includes the generation modes the vendor docs confirm (t2v, i2v, reference-to-video, start/end, v2v, lip sync; unknown where docs do not say). Legacy, deprecated and discontinued models are never recommended. Filters by the required mode FIRST (detected from the shot text or the mode argument; endpoints whose docs say unknown are excluded), then ranks the cheapest qualifying endpoint first and notes when a pricier one has more proof. Includes each endpoint's max clip length and splits long clips.

{
  "type": "object",
  "properties": {
    "shot": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "t2v",
        "i2v",
        "r2v",
        "start_end",
        "v2v",
        "lipsync"
      ],
      "description": "Required generation mode; detected from the shot text when omitted"
    },
    "budget_usd": {
      "type": "number",
      "description": "Total budget for all clips"
    },
    "max_per_shot": {
      "type": "number",
      "description": "Max USD per clip"
    },
    "clip_seconds": {
      "type": "number",
      "default": 5
    },
    "clips": {
      "type": "integer",
      "default": 1
    }
  },
  "required": [
    "shot"
  ]
}

Vendor-stated AI video prices per second from AI Video Atlas's tracker, each with its source URL and the date we checked it. Filter by model family or host. Legacy, deprecated and discontinued rows are excluded unless include_legacy=true (then they are flagged by status). Use for "how much does X cost", "cheapest model", or before quoting any cost.

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string"
    },
    "host": {
      "type": "string"
    },
    "include_legacy": {
      "type": "boolean",
      "default": false
    },
    "sort": {
      "type": "string",
      "enum": [
        "cheapest",
        "model"
      ],
      "default": "cheapest"
    }
  }
}

How-to workflows, tools and model guides for AI video, grouped by job: consistent-character (Keep a character consistent), lip-sync (Lip sync & talking heads), product-ad (Product ads & UGC), camera (Direct the camera), long (Longer & multi-shot videos), i2v (Animate a still image), edit (Edit or restyle footage), upscale (Upscale & smooth), local (Run it on your own GPU), models (Models & hosts). Pass job for a curated list, query for free text (e.g. "comfyui lipsync", "upscale to 4k"), or slug for one item in full. Returns sources, creators, license and price as stated.

{
  "type": "object",
  "properties": {
    "job": {
      "type": "string",
      "enum": [
        "consistent-character",
        "lip-sync",
        "product-ad",
        "camera",
        "long",
        "i2v",
        "edit",
        "upscale",
        "local",
        "models"
      ]
    },
    "query": {
      "type": "string"
    },
    "slug": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 25
    }
  }
}

Prompting guidance from AI Video Atlas, sourced from vendor prompting docs (Google, BytePlus, Runway, Luma, MiniMax, Alibaba, LTX, xAI, fal) plus proven Atlas examples. Pass model (kling, veo, seedance, runway, luma, hailuo, wan, ltx, grok-imagine…) for prompt structure, camera language, what the model responds to, things to avoid and known limits; or topic (shot-vocabulary, tagging, consistent-characters, i2v-vs-r2v, setup-playbooks). Every item carries its source URL; items marked atlas-editorial are our summary, not a vendor claim. Call with no arguments to list what exists. Use before writing a prompt for a specific model.

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model family, e.g. kling, veo, seedance, runway, luma, hailuo, wan, ltx, grok-imagine"
    },
    "topic": {
      "type": "string",
      "enum": [
        "consistent-characters",
        "i2v-vs-r2v",
        "setup-playbooks",
        "shot-vocabulary",
        "tagging"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "structure",
        "camera",
        "responds_to",
        "mode",
        "consistency",
        "tagging",
        "audio",
        "avoid",
        "limits",
        "workflow",
        "technique",
        "pricing"
      ],
      "description": "Optional filter, e.g. camera or avoid"
    }
  }
}

What is new in AI Video Atlas: the newest sourced shots and guides added in the last N days (default 7), newest first, with X like counts where we have them ("new" otherwise). Use for "what's new in AI video", weekly roundups, or trend questions. For the full weekly digest (new models, price changes, new shots, legacy prices) read https://aivideoatlas.com/digest/latest.json.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "default": 7,
      "maximum": 60
    },
    "kind": {
      "type": "string",
      "enum": [
        "shots",
        "guides",
        "all"
      ],
      "default": "all"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 30
    }
  }
}