FilmLab

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "seq_id",
    "type"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Text content for type 'title', 'credits' or 'lower_third'"
    },
    "type": {
      "enum": [
        "video",
        "image",
        "title",
        "credits",
        "lower_third"
      ],
      "type": "string",
      "description": "What this clip is. 'image' references a generated image via source_id; 'title', 'credits' and 'lower_third' carry `text` instead. 'lower_third' is an OVERLAY: appended without start_time it is laid over the clip before it (track V2), takes no time of its own and never runs past that clip's end; metadata.versatz_s delays it inside that clip. As the very first clip it is a card on black. 'video' is where it gets sharp — read the source_id note before using it"
    },
    "seq_id": {
      "type": "string",
      "description": "Sequence id (from lab_create_sequence/lab_list_sequences) — positive integer as string"
    },
    "metadata": {
      "type": "object",
      "description": "JSON stored alongside the clip. The continuity pass reads video_id (a generated video's id — it checks the start image), image_url (a frame URL), location_id and scene_num from here; for a 'lower_third', versatz_s (seconds into the clip it sits on) sets when it appears; other keys are stored as-is",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "source_id": {
      "type": "string",
      "description": "For type 'image': the id of a generated image (from lab_generate). For type 'video': source_id is IGNORED by the continuity pass (a video id used to be misread as an unrelated image, see vault/followups/2026-08-04-continuity-loest-source-id-blind-auf.md). Give a video clip its frame via metadata instead: metadata.video_id = the generated video's id (the pass checks the video's start image), or metadata.image_url = a frame URL. Without either, the shot is counted as 'not checked' (summary.ohne_frame)."
    },
    "start_time": {
      "type": "number",
      "minimum": 0,
      "description": "Absolute start on the timeline. Omit to append after the last clip (the normal case); set it only to place a clip deliberately"
    },
    "duration_seconds": {
      "type": "number",
      "maximum": 300,
      "minimum": 0.1,
      "description": "Clip duration in seconds. Backend default is 5.0 — pass the clip's REAL length, otherwise the sequence duration and the render drift apart"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "art",
    "herkunft"
  ],
  "properties": {
    "art": {
      "enum": [
        "video",
        "audio",
        "image"
      ],
      "type": "string",
      "description": "What the file is"
    },
    "herkunft": {
      "enum": [
        "eigen",
        "ki"
      ],
      "type": "string",
      "description": "Required, no default: 'eigen' = shot, recorded or made by people (no AI generation); 'ki' = generated or altered with AI. Decides the EU AI Act Art. 50 disclosure of every export that uses this file. If the file itself carries an AI mark (C2PA or IPTC source type), it stays AI material whatever you declare, and the answer says so."
    },
    "file_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Name of a local file to upload, with extension. Give this OR media_url"
    },
    "media_url": {
      "type": "string",
      "format": "uri",
      "description": "Public http(s) URL of the file. Give this OR file_name"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    },
    "content_type": {
      "type": "string",
      "description": "Media type of the upload, e.g. video/mp4, audio/mpeg — required with file_name"
    },
    "abschluss_key": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "Only after an upload whose answer said `abschluss_noetig`: the `abschluss_key` from that answer, given AFTER the PUT returned 200. Give it instead of media_url and file_name"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "prompt"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "maximum": 4294967295,
      "minimum": 0,
      "description": "Seed for a repeatable run. Omit it and the project's stored seed applies (POST /api/lab/projects/{id}/einstellungen), and without that the provider picks one. The seed that actually rendered comes back in lab_job_status as `seed` with `seed_quelle` ('provider' = read from the provider's answer, 'gesetzt' = the one sent, null = the model tells no seed). Models whose endpoint has no seed field do not drop a given seed silently: the run proceeds and the row carries `seed_hinweis: seed_nicht_unterstuetzt` — some models tell their seed but take none, others take one but tell none."
    },
    "tool": {
      "type": "string",
      "description": "Video model id — copy it verbatim from lab_list_models (kind: video). Omit to let the intent router choose. Every model has its own resolutions, duration grid, audio behaviour and price; the catalog is the only place those live, this text deliberately names none."
    },
    "shots": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "prompt"
        ],
        "properties": {
          "prompt": {
            "type": "string",
            "minLength": 1,
            "description": "What happens in THIS shot"
          },
          "duration_seconds": {
            "type": "integer",
            "maximum": 15,
            "minimum": 1,
            "description": "Length of this shot (default 5)"
          }
        }
      },
      "description": "Multi-shot: a sequence of shots rendered as ONE output, holding character, place and voice across the cuts. This is NOT the same as several clips stitched together — those you pay for individually and they do not hold the cast. PRICE: the billed length is the SUM of the shot durations, not duration_seconds. Three 5s shots cost the same as one 15s clip (140 credits at the reference resolution), not the same as one 5s clip (47). The sum must fit the provider's 3-15s window — each shot may be legal on its own and the sum still too long. Only kling_3_pro. Requesting it elsewhere is rejected before quota is spent."
    },
    "in_sec": {
      "type": "number",
      "description": "Cut the reference clip server-side before it reaches the provider: start of the excerpt, in seconds from the clip's beginning. Only together with out_sec, and only with source_video_id."
    },
    "intent": {
      "type": "string",
      "description": "Say WHAT the shot is instead of picking a model — the router chooses by priority and a cost cap. 'draft' and 'ambient' route to the cheapest provider, 'dialog' to the one with the steadiest faces, 'hero' to the most expensive on purpose, 'atmo' for atmosphere. Prefer intent over tool: it also gives you an automatic fallback to the next provider if the first one hard-fails. An explicitly set `tool` always wins over intent."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "Motion/camera instruction for the animation. For a clip of 4 s or longer, write the action as timed beats, one per line under a '// Action Timing' header: '[0-2s] [CAM 01] <framing> -> [ACT] <action> -> [DIAL] <who>: \"<line>\" -> [AUDIO] <sound>'. The spans start at 0 and cover duration_seconds; keep the same CAM number while the camera does not cut. lab_prompt_transform (medium video) writes exactly this form. Murnau's SceneFlow lights each beat while the clip plays, and the crew judges it there."
    },
    "familie": {
      "enum": [
        "seedance-2.0",
        "seedance-2.5"
      ],
      "type": "string",
      "description": "Pick the MODEL, not the access route: 'seedance-2.0' or 'seedance-2.5'. The server takes the cheapest route that this account may use and that can do the job (OpenRouter only with the user's consent; references, 1080p for 2.5, or audio switched off go to fal) and falls back to fal if a cheaper route fails — the fallback can cost more than the preflight price. Mutually exclusive with tool and intent."
    },
    "out_sec": {
      "type": "number",
      "description": "End of the excerpt in the reference clip, in seconds. Must lie behind in_sec; both are set together or neither. Only with source_video_id."
    },
    "get_cost": {
      "type": "boolean",
      "description": "Preflight: return the price in credits and your balance WITHOUT generating, reading the same catalog as lab_list_models. Do this before a batch or when the user wants to see the cost. For a card the user confirms, use lab_propose instead."
    },
    "metadata": {
      "type": "object",
      "description": "Free-form JSON stored alongside the video. Not interpreted by the pipeline.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "prop_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Prop ids from lab_list_props, belonging to this project (an @prop_ tag in the prompt does the same). Animating an image: the descriptions go into the prompt as text, no prop image is sent. From a clip (source_video_id): the front views join the reference images on free slots, as in lab_reference_motion."
    },
    "audio_url": {
      "type": "string",
      "description": "URL of an existing audio track to lay under the clip. Independent of generate_audio, which asks the PROVIDER to synthesise its own."
    },
    "scene_ref": {
      "type": "string",
      "description": "Scene label (e.g. 'SZ 04'). Stored on the row, so clips can be matched back to a shot list and reviewed per scene with lab_review_queue."
    },
    "shot_type": {
      "enum": [
        "customize",
        "intelligent"
      ],
      "type": "string",
      "description": "How to cut a multi-shot clip. 'customize' (default) renders exactly the shots you gave. 'intelligent' lets the model decide the cutting — your shot prompts become a suggestion, not a spec. Belongs to `shots`; alone it is rejected."
    },
    "apply_lens": {
      "type": "boolean",
      "description": "Defaults to TRUE on the backend: the project's lens_state UrPrompt is appended to the prompt. Pass false only to deliberately opt out for this one call."
    },
    "kamerapfad": {
      "type": "object",
      "description": "The camera move as INPUT instead of prose: an object following shared/kamerapfad/schema.json — poses over time (position, look-at or quaternion, metres, Y up) from the Kadrage terrain flight or drawn by hand, or motion phases as lab_kamerafahrt reads them from a clip (its answer carries a ready `kamerapfad`). The backend validates it, derives phases, and then writes the move into the prompt IN THE FORM THIS MODEL UNDERSTANDS: prose at the camera slot for most families, bracketed director commands inside the prompt string for the MiniMax/Hailuo family, which parses them. NO MODEL RECEIVES THE POSES TODAY — the answer says which form went out (kamerapfad.angewandt = als_text or als_regiebefehle), names the family rule and the source it rests on (kamerapfad.sprache), and lists what that form could not carry (kamerapfad.nicht_gesendet, kamerapfad.befehle_weggefallen next to kamerapfad.befehle_gesamt). IF YOUR OWN PROMPT ALREADY CARRIES BRACKETED COMMANDS and the model parses them, the path is NOT sent on top of them — two chains would contradict each other at the same parser; the answer then says angewandt = eigene_regie and names what it found in kamerapfad.eigene_regiebefehle, and your prompt goes out unchanged. A `zusammenfassung` inside the path is display only and is NEVER sent — the move is always rebuilt from the phases; if nothing can be built (phases without tempo/verlauf), the answer says angewandt = nicht_ableitbar with the reason, and nothing of the path is in the prompt. Mutually exclusive with kamerapfad_url.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects)"
    },
    "referenzen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "art"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The reference as an ID instead of an address, looked up in this project: an image id (lab_generate/lab_job_status), a video id (lab_animate), an audio id (lab_list_audio), or an asset key (lab_list_assets). The URL is never built here — it comes from the backend's answer, because the bucket is not guessable and a hand-built address renders, bills, and then leads nowhere."
          },
          "art": {
            "enum": [
              "bild",
              "video",
              "ton"
            ],
            "type": "string",
            "description": "Which channel this reference goes into: bild an image, video a clip, ton a sound. The channel is not the same as the role — an image can be a character, a place or a look, and only you know which; say it in `rolle`. How many of each a model takes is in lab_list_models (referenz_grenzen); a channel the model has no slot for is rejected before anything is charged."
          },
          "url": {
            "type": "string",
            "description": "Address of the reference. Exactly one of url or id — both together means two sources for one address, and one of them would silently lose."
          },
          "rolle": {
            "type": "string",
            "description": "WHICH character or place this reference means. Free text, carried through — not derivable from `art`, and guessing it would be a claim about the cast nobody made."
          }
        }
      },
      "description": "Typed references for the clip path (source_video_id). The position IS the address: the first image is @Image1, the first extra clip is @Video2 (the reference clip itself is @Video1), the first sound is @Audio1. Write @bild1/@video1/@ton1 in the prompt and they are resolved to exactly these positions HERE, before anything is sent — no detour through lab_prompt_transform needed (it resolves them too when it rewrites a prompt). Every image reference is MEASURED before it is sent and scaled up to the model's minimum if it is below it; nothing is ever rejected for being small."
    },
    "resolution": {
      "type": "string",
      "description": "Resolution tier, exactly as listed for the model in lab_list_models. Omit for the model's default. Some models have no resolution field at all — then leave it out."
    },
    "location_id": {
      "type": "string",
      "description": "Location board id (from lab_list_locations). The board's `prompt_prefix_en` is appended to your prompt as 'Location: …', so a clip stays in the same place as the images shot there. A board WITHOUT a prefix anchors nothing and fails silently — check with lab_list_locations."
    },
    "stil_kit_id": {
      "type": "string",
      "description": "Style kit id from lab_list_stil_kits (an @stil_ tag in the prompt does the same). Omit it and the project's default kit applies (lab_stil_kit_standard); its rules and palette go into the prompt as text, and its reference images join only where the call already sends reference images (characters or props) and the model has a free slot after them. The answer says which way it went (stil_kit.weg)."
    },
    "end_image_id": {
      "type": "string",
      "description": "id of a completed image to land the clip on (last frame). REQUIRES a start frame (source_image_id or character_refs) — an end frame alone is rejected before quota is spent. Only kling_3_pro."
    },
    "camera_motion": {
      "enum": [
        "dolly_in",
        "dolly_out",
        "dolly_left",
        "dolly_right",
        "jib_up",
        "jib_down",
        "static",
        "focus_shift"
      ],
      "type": "string",
      "description": "Structured camera move sent to the model itself — only models whose lab_list_models entry lists camera_motions. Prefer this over prose when a keyframe chain must MOVE rather than cross-fade."
    },
    "ohne_keyframe": {
      "type": "boolean",
      "description": "Skip the keyframe checkpoint on purpose. By default a paid clip only starts from a start image the user has approved (lab_review_asset verdict: accepted) — look at the frame first, then spend on the clip. Set true only when the user explicitly asked to skip the frame check."
    },
    "ohne_stil_kit": {
      "type": "boolean",
      "description": "true switches the project's default style kit off for this one call."
    },
    "character_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Character ids (positive integer strings) whose reference image locks the cast's identity for this clip. On most providers only the FIRST character's image is used, as the start frame — with two characters in frame the second is unbound. On kling_3_pro each character additionally becomes its own reference element (frontal view plus up to 3 further angles from its sheet), so all of them are bound. The response reports `elements_bound` and `characters_without_reference`."
    },
    "generate_audio": {
      "type": "boolean",
      "description": "Ask for the model's native audio track. Only meaningful where lab_list_models says audio: schaltbar — models with audio: immer always have it, audio: nie never."
    },
    "kamerapfad_url": {
      "type": "string",
      "description": "Address of a kamerapfad JSON instead of the object — the url of a file in THIS project (lab_list_assets), e.g. the kamerapfad JSON that Kadrage writes next to its flight video. Fetched by the backend under the same ownership rule as every reference: a file of another project is a named rejection before anything is charged. Mutually exclusive with kamerapfad."
    },
    "source_image_id": {
      "type": "string",
      "description": "id of a completed image (from lab_generate/lab_job_status) to animate — positive integer as string. Required unless get_cost is true. Imported Midjourney images work directly: use an image_id from lab_umzug."
    },
    "source_video_id": {
      "type": "string",
      "description": "Animate FROM A CLIP instead of a still: the id of a generated video (from lab_animate/lab_job_status) or the asset key of an uploaded one (from lab_list_assets, asset_type 'video'). The run then goes to the reference-motion path — your clip leads, the model restyles it. Mutually exclusive with source_image_id, and only for models that take a video reference (lab_list_models says v2v); The picture-side fields (end frame, shots, audio, location) do not travel this path and are rejected rather than dropped; character references exist here under a different name (ready image URLs instead of sheet ids) and are rejected too, with that reason. An intent IS resolved before the run and travels as the chosen model."
    },
    "character_states": {
      "type": "object",
      "description": "Which STATE each character is in for this clip, as { characterId: stateKey } — e.g. { \"12\": \"wet\" }. A state is its own asset with its own full descriptor (clean / soaked / bloodied are three assets, not one with a note), and it is the ONLY way that descriptor reaches a generation: the reference image always carries the BASE state, so without this field you get dry Cal in a scene where he just came out of the Thames — and the clip looks correct. Get the keys from lab_get_character_sheet. Every id here must also appear in character_refs (who is not in the frame is not described), and an unknown key is rejected before any quota is spent.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "character_voices": {
      "type": "object",
      "description": "Bind a voice per character: character id -> fal voice id. Voice ids come from fal-ai/kling-video/create-voice — FilmLab keeps no voice registry of its own, the id is passed through unverified. Every character named here must also be in character_refs AND must have a generated reference image (no image → no element → nothing to bind the voice to; rejected before quota is spent). Only kling_3_pro.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "dreamer_signatur": {
      "type": "string",
      "description": "Proof from the Dreamer (lab_prompt_transform, or the dreamer_fassung of a previous call) that THIS prompt went through it. Without a valid one the tool does not generate: it runs the Dreamer and returns its version first."
    },
    "duration_seconds": {
      "type": "number",
      "maximum": 30,
      "minimum": 1,
      "description": "Clip length in seconds. Must lie inside the model's duration grid from lab_list_models; inside the grid the provider may snap to its nearest step. IGNORED when `shots` is given — then the rendered length is the sum of the shot durations."
    },
    "abdruck_startframe": {
      "type": "boolean",
      "description": "Generate frame one WITH the character's trained Figurenabdruck (LoRA) instead of taking the flat studio portrait from the character sheet — the clip then starts IN the scene rather than in a photo studio. Opt-in: it costs one extra image (3 credits). Needs EXACTLY ONE character_ref that has a finished Abdruck, and is rejected together with source_image_id (that one PICKS frame one, this one MAKES it). Refused before any quota is spent."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "seq_id"
  ],
  "properties": {
    "seq_id": {
      "type": "string",
      "description": "Sequence id (from lab_create_sequence/lab_list_sequences) — positive integer as string"
    },
    "toleranz_s": {
      "type": "number",
      "maximum": 2,
      "minimum": 0,
      "description": "How far a cut point may travel to land on a beat, in seconds (default 0.12 — three frames at 25 fps). 0 disables snapping entirely and only recomputes the durations"
    },
    "trotz_unsicherem_tempo": {
      "type": "boolean",
      "description": "Snap onto a grid whose own measurement reports `verlaesslich: false`. Default false, and that default is the honest one: below the threshold the detector has not confirmed it found the pulse. Set it only as a deliberate decision — the answer then carries raster.unsicheres_tempo_uebergangen: true"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "prompt"
  ],
  "properties": {
    "art": {
      "type": "string",
      "minLength": 1,
      "description": "Which breakdown. Default coverage. Known: coverage, dialog, winkel, hoehen, orbit, pov, naehe, gesicht, haende, reaktionen, zwischenschnitte (aufloesung); ursache_wirkung, entdeckung, zeitverlauf, gefuehlswende, kleiner_bogen (montage)."
    },
    "laenge": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Number of shots: 2, 4 or 6. Default 4. Never odd — a breakdown runs in pairs."
    },
    "prompt": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1,
      "description": "The scene or the master prompt to break down"
    },
    "scene_ref": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional scene reference the shots are filed under when uebernehmen=true"
    },
    "project_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The project the scene belongs to",
      "exclusiveMinimum": 0
    },
    "uebernehmen": {
      "type": "boolean",
      "description": "Default false. true appends the shots to the project's shot list — ask first."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "model": {
      "enum": [
        "krea_2_medium",
        "krea_2_large",
        "krea_2_turbo",
        "flux_pro"
      ],
      "type": "string",
      "description": "Image model for the frames. Default krea_2_medium. Prices per model: lab_list_models."
    },
    "format": {
      "enum": [
        "16:9",
        "9:16"
      ],
      "type": "string",
      "description": "Frame aspect ratio for every model, default 16:9"
    },
    "script": {
      "type": "string",
      "maxLength": 80000,
      "minLength": 20,
      "description": "Screenplay or scene description; provide either script or situationen. The backend splits script into scenes; each scene becomes one image."
    },
    "figur_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Existing character-sheet id with a reference image; required for situationen, only used with situationen",
      "exclusiveMinimum": 0
    },
    "creativity": {
      "enum": [
        "raw",
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "description": "Krea 2 creativity setting; ignored by flux_pro. Default medium."
    },
    "max_scenes": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Upper limit for the number of scenes, and therefore images charged. Backend default when omitted."
    },
    "project_id": {
      "type": "string",
      "description": "Project id"
    },
    "situationen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "bild_en",
          "bewegung_en"
        ],
        "properties": {
          "bild_en": {
            "type": "string",
            "maxLength": 4000,
            "minLength": 1,
            "description": "English still prompt: one moment, one action"
          },
          "bewegung_en": {
            "type": "string",
            "maxLength": 1000,
            "minLength": 1,
            "description": "English motion prompt with a strong movement verb"
          }
        }
      },
      "maxItems": 16,
      "minItems": 8,
      "description": "Independent situations, each exactly one frame. Requires figur_id; excludes script and figuren_raten."
    },
    "figuren_raten": {
      "type": "boolean",
      "description": "Opt-out, off by default: true skips the character references and lets the image model invent every character from the text — a different face in every frame. Only set it when the human explicitly asks for that; it is recorded on every frame (figuren_geraten)."
    },
    "style_reference_url": {
      "type": "string",
      "description": "Shared moodboard image applied to ALL frames for one consistent look. Used by Krea 2 and by the Seedream character-reference path (one additional reference, included in pricing). Must be an asset of this project or an absolute URL — anything else is refused before credits are spent."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "seq_id"
  ],
  "properties": {
    "takt": {
      "type": "integer",
      "maximum": 16,
      "minimum": 1,
      "description": "Beats per bar (default 4). INPUT, not detection — time-signature detection is explicitly out of scope. It only affects where the downbeats fall, which is what the rhythm 'auf die Songstruktur' snaps to"
    },
    "seq_id": {
      "type": "string",
      "description": "Sequence id (from lab_create_sequence/lab_list_sequences) — positive integer as string"
    },
    "neu_messen": {
      "type": "boolean",
      "description": "Measure again even though a result for this exact file already exists. Default false. The measurement is deterministic — the same file gives the same number, so this only helps after the track behind the url was swapped"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "age": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Age in years, as a number"
    },
    "eyes": {
      "type": "string",
      "description": "Eye colour and expression"
    },
    "hair": {
      "type": "string",
      "description": "Hair colour, length, cut"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Character name, e.g. 'Maren' — the only required field"
    },
    "skin": {
      "type": "string",
      "description": "Skin tone and texture"
    },
    "build": {
      "type": "string",
      "description": "Body build and posture"
    },
    "gender": {
      "type": "string",
      "description": "e.g. 'female', 'male', 'non-binary'"
    },
    "gattung": {
      "enum": [
        "mensch",
        "tier",
        "kreatur",
        ""
      ],
      "type": "string",
      "description": "Character kind: human, animal or creature. Omitted or empty means mensch. For tier/kreatur, begin the description with the species and its distinctive features."
    },
    "clothing": {
      "type": "string",
      "description": "Default costume the character is seen in"
    },
    "demeanor": {
      "type": "string",
      "description": "How the character moves and behaves, in prose"
    },
    "project_id": {
      "type": "string",
      "description": "Bind the sheet to this project (from lab_list_projects) — positive integer as string. PASS THIS whenever the character belongs to a project. Without it the sheet stays an orphan: lab_cast_gaps will not count it as created, and image generation will not find it as a char_ref."
    },
    "project_name": {
      "type": "string",
      "description": "Free-text project label shown in listings (does NOT bind the sheet — that is project_id)"
    },
    "facial_features": {
      "type": "string",
      "description": "Face shape, nose, mouth, jaw — what makes this face recognisable"
    },
    "distinctive_features": {
      "type": "string",
      "description": "Scars, tattoos, glasses, anything that must appear in every image"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Board name, e.g. 'Wohnung Hanna — Balkon'"
    },
    "props": {
      "type": "string",
      "description": "Objects that must be present"
    },
    "colors": {
      "type": "string",
      "description": "Dominant palette"
    },
    "atmosphere": {
      "type": "string",
      "description": "Mood, weather, sound of the place"
    },
    "project_id": {
      "type": "string",
      "description": "Bind the board to this project (from lab_list_projects) — positive integer as string"
    },
    "description": {
      "type": "string",
      "description": "What the place is, in prose"
    },
    "time_of_day": {
      "type": "string",
      "description": "e.g. 'morning', 'blue hour', 'night'"
    },
    "architecture": {
      "type": "string",
      "description": "Building style, era, materials"
    },
    "project_name": {
      "type": "string",
      "description": "Free-text project label shown in listings"
    },
    "location_type": {
      "type": "string",
      "description": "e.g. 'interior', 'exterior', 'apartment', 'street'"
    },
    "lighting_notes": {
      "type": "string",
      "description": "Light direction, quality, sources"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "video_id"
  ],
  "properties": {
    "neu": {
      "type": "boolean",
      "description": "Start a new depth job instead of reusing the existing map or running job (default false)"
    },
    "modell": {
      "enum": [
        "v2",
        "vda"
      ],
      "type": "string",
      "description": "Depth engine: v2 (default, sharpest) or vda (steady over time, 16:9 or 9:16 only)"
    },
    "wait_s": {
      "type": "number",
      "maximum": 15,
      "minimum": 0,
      "description": "Wait up to this many seconds for completion (default 0, maximum 15)"
    },
    "video_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Completed video id belonging to this project",
      "exclusiveMinimum": 0
    },
    "nur_lesen": {
      "type": "boolean",
      "description": "Only read: never create a job. Without an existing job the answer is status 'keine' (default false)"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "seq_id",
    "language"
  ],
  "properties": {
    "seq_id": {
      "type": "string",
      "description": "Sequence id (from lab_create_sequence/lab_list_sequences) — positive integer as string"
    },
    "backend": {
      "enum": [
        "replicate",
        "inhouse",
        "veed_v2"
      ],
      "type": "string",
      "description": "Lipsync engine. Omit to use the backend default (replicate — ROI-crop, best for one long static talking-head shot). veed_v2 renders the full frame instead and is the pick for multi-shot sequences or a partly hidden mouth. 'inhouse' shares replicate's ROI-crop path."
    },
    "dub_text": {
      "type": "string",
      "maxLength": 5000,
      "minLength": 1,
      "description": "The line(s) this cloned voice should read, in the target `language`. Required together with voice_id."
    },
    "get_cost": {
      "type": "boolean",
      "description": "`true` reports the price and your balance WITHOUT starting a dub and without spending quota. The number is computed by the same function that later charges you, from THIS sequence: a sound rate per video clip, plus the chosen lipsync engine's own rate over the sequence's running time, plus a surcharge for the cloned-voice reading. `preisbasis` in the answer breaks it into those parts, so you can see which switch moves which share — turning the lipsync pass off removes its whole item. Not drawn from the lab_list_models catalog (that covers image and video models only; the lipsync engine is chosen with `backend` here, and dub has no catalog entry)."
    },
    "language": {
      "type": "string",
      "minLength": 1,
      "description": "Target language for the dub, e.g. 'de', 'fr', 'es' — drives the cloned voice's TTS. Required: there is no silent default here."
    },
    "voice_id": {
      "type": "string",
      "description": "A cloned voice's id (lab_cloned_voices.id, from lab_voice_clone or lab_list_voices) — positive integer as string. Required together with dub_text, and mutually exclusive with en_audio_url."
    },
    "einwilligung": {
      "type": "boolean",
      "description": "Consent of the person whose mouth this dub re-syncs, when there is no Likeness Register id for them yet. Required together with einwilligung_notiz if likeness_ref is not given — a dub always alters a real person's mouth in existing footage, so one of the two consent forms is mandatory, checked before anything is spent. This is a caller attestation, not a registry check like likeness_ref — logged, not verified against likeness.thefilmradar.com. Do not set it to be rid of the error — set it because the consent exists."
    },
    "en_audio_url": {
      "type": "string",
      "minLength": 1,
      "description": "URL of a READY dub track to lay under the sequence — typically the audio_url lab_dub_tts just returned. Mutually exclusive with voice_id+dub_text: a dub has exactly one audio source, and picking one silently would throw away the other after it was paid for."
    },
    "likeness_ref": {
      "type": "string",
      "description": "A Likeness Register consent id (likeness.thefilmradar.com) for the person whose mouth this dub re-syncs. Checked live against the register before anything is spent; a revoked or unknown id refuses the call. Mutually exclusive with einwilligung+einwilligung_notiz — one form of consent is required, not both."
    },
    "enable_lipsync": {
      "type": "boolean",
      "description": "Whether to run the visual lipsync pass at all. Omit to use the backend default (on). Off only swaps the audio track and skips the mouth-sync render entirely."
    },
    "einwilligung_notiz": {
      "type": "string",
      "maxLength": 2000,
      "description": "Free text: who consented, when, and for what — required together with einwilligung. Goes on record with the generated clip."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "seq_id"
  ],
  "properties": {
    "gegen": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "vergleichen: a second state instead of the current cut",
      "exclusiveMinimum": 0
    },
    "marke": {
      "type": "string",
      "maxLength": 200,
      "description": "markieren: the name. Empty removes it"
    },
    "titel": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "abzweigen: the name of the new version"
    },
    "aktion": {
      "enum": [
        "liste",
        "markieren",
        "vergleichen",
        "zurueckholen",
        "abzweigen"
      ],
      "type": "string",
      "description": "What to do. Default 'liste'"
    },
    "seq_id": {
      "type": "string",
      "description": "Sequence id (from lab_list_sequences) — positive integer as string"
    },
    "checkpoint_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The state (id from 'liste'). Needed for markieren, vergleichen, zurueckholen; optional for abzweigen (without: the current cut)",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "prompt"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "maximum": 4294967295,
      "minimum": 0,
      "description": "Seed for a repeatable run. Omit it and the project's stored seed applies (POST /api/lab/projects/{id}/einstellungen), and without that the provider picks one. The seed that actually rendered comes back in lab_job_status as `seed` with `seed_quelle` ('provider' = read from the provider's answer, 'gesetzt' = the one sent, null = the model tells no seed). Models whose endpoint has no seed field do not drop a given seed silently: the run proceeds and the row carries `seed_hinweis: seed_nicht_unterstuetzt` — some models tell their seed but take none, others take one but tell none."
    },
    "tool": {
      "type": "string",
      "description": "Image model id — copy it verbatim from lab_list_models (kind: image). Omit to use the default. Every model has its own resolutions, aspect handling and price; the catalog is the only place those live, this text deliberately names none."
    },
    "aspect": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "maxItems": 2,
      "minItems": 2,
      "description": "Frame as [width, height], e.g. [9, 16]. Overrides the project's pose_state — pass it when the Pose-Director's blockout is set but not yet saved. Measured 2026-07-31: without it a 9:16 blockout came back as 16:9, because pose_state was still NULL."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "What to generate (required)"
    },
    "wait_s": {
      "type": "number",
      "maximum": 80,
      "minimum": 0,
      "description": "Seconds to wait for the finished image before answering (default 45, max 80). 0 = answer immediately with pending rows."
    },
    "anker_id": {
      "type": "string",
      "description": "Look anchor id (positive integer string) whose CHOSEN image guides this generation as img-to-img. An anchor is a look imported from Midjourney: a handful of images plus the grammar of the old `--profile` code, stored per project. It resolves to exactly ONE image — the one the anchor's `gewaehlt` points at — because the provider payload carries one reference, not a set. So this is MUTUALLY EXCLUSIVE with seed_image_url (two sources for one field), and character_refs still wins over both: identity beats look. Build one from imported images with lab_umzug {anker}; list anchors with GET /api/lab/projects/<id>/umzug/anker."
    },
    "get_cost": {
      "type": "boolean",
      "description": "Preflight: return the price in credits and your balance WITHOUT generating, reading the same catalog as lab_list_models. Do this before a batch or when the user wants to see the cost. For a card the user confirms, use lab_propose instead."
    },
    "metadata": {
      "type": "object",
      "description": "Free-form JSON stored alongside the image (e.g. { parent_id, note }). Not interpreted by the pipeline.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "prop_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Prop ids from lab_list_props, belonging to this project (an @prop_ tag in the prompt does the same). Their descriptions go into the prompt, and each prop's FRONT view goes along as a reference image — after the characters, before the style kit; a prop alone may switch a text-to-image call to image-to-image (not on the abdruck path). The answer says which way it went (props.weg, props.grund)."
    },
    "variants": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "How many variants to generate (default 1, max 5)"
    },
    "scene_ref": {
      "type": "string",
      "description": "Scene label (e.g. 'SZ 04'). Stored on the row, so results can be matched back to a shot list and reviewed per scene with lab_review_queue. Omit it and the image is an orphan."
    },
    "apply_lens": {
      "type": "boolean",
      "description": "Defaults to TRUE on the backend: the project's lens_state UrPrompt is appended to the prompt. Pass false only to deliberately opt out for this one call."
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — generation is always project-scoped"
    },
    "resolution": {
      "type": "string",
      "description": "Resolution tier, exactly as listed for the model in lab_list_models. Omit for the model's default; the aspect ratio still comes from the project's pose_state — this only sets the area. Some models have no resolution field at all — then leave it out."
    },
    "location_id": {
      "type": "string",
      "description": "Location board id (from lab_list_locations). Anchors the shot: the board's `prompt_prefix_en` is appended to your prompt as 'Location: …' before generation, so every image of the same place stays in the same place. Check the prefix with lab_list_locations first — a board WITHOUT a prefix anchors nothing and fails silently."
    },
    "stil_kit_id": {
      "type": "string",
      "description": "Style kit id from lab_list_stil_kits (an @stil_ tag in the prompt does the same). Omit it and the project's default kit applies (lab_stil_kit_standard); its rules and palette go into the prompt as text, and its reference images join only where the call already sends reference images (characters or props) and the model has a free slot after them. The answer says which way it went (stil_kit.weg)."
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Aspect ratio as W:H (e.g. 16:9, 9:16). Must be one of the model's aspect_ratios where the model has an enum; models without an enum accept any W:H. Omit to use the project's camera aspect."
    },
    "costume_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The costume plate of these characters goes along as an extra reference image — the outfit on an invisible mannequin, NO person, so it carries the costume, never the face. Every id must also be in character_refs. Needs a model whose max_references covers characters + plates (lab_list_models); otherwise rejected before any quota is spent. Each plate is one more reference and may cost credits; get_cost prices it."
    },
    "ohne_stil_kit": {
      "type": "boolean",
      "description": "true switches the project's default style kit off for this one call."
    },
    "character_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Character ids (positive integer strings) whose reference images lock the cast's identity. Routes the call to img-to-img and sends EVERY listed character's reference image, in the order given, up to the max_references (lab_list_models) of the model that actually runs. WITH A CHARACTER, flux_pro — the default — RUNS AS flux_2_pro (FLUX.2 [pro] edit), which takes up to 9 references: the answer names the switch in `umgeschaltet` (von/nach), and get_cost prices flux_2_pro. flux_pro's own img-to-img variant (redux) only varies its source image and dropped the scene in every measured case; it is still used for seed_image_url without characters, where the source's composition is wanted. A model that takes fewer references than you name: naming more with that tool explicitly is rejected before any quota is spent; without an explicit tool the image is made with the first max_references and the answer names the rest in `referenz_warnung` and `referenzen.nicht_gesendet` — nothing is dropped silently. Each additional reference may cost credits; get_cost with character_refs prices exactly that. This OVERRIDES seed_image_url: the characters fill the reference slots, and identity wins over composition. A character without a generated reference image is rejected before any quota is spent. GET IDS FROM lab_list_characters, or create one with lab_create_character followed by lab_generate_character_reference. Prefer character_refs over seed_image_url whenever a person must stay the same across images: seed_image_url holds identity only for the single call that passes it, character_refs is a register entry that every later call can name. SCENE AND LIGHT FOLLOW THE PROMPT: the reference holds the person, not the shot — harbour at night, stairwell under a top light, neon in the rain all came out as asked with the face kept (measured 2026-10-05 on flux_2_pro). What the reference does NOT change is the character's condition: it always shows the BASE state. For a wet, injured or otherwise changed character pass character_states instead of describing it in the prompt (lab_get_character_sheet returns the state keys and the descriptors behind them); to hold the outfit itself, add its costume plate with costume_refs."
    },
    "seed_image_url": {
      "type": "string",
      "description": "Optional: run img-to-img guided by this existing image URL (e.g. a prior generation's url). For a PERSON who must look the same across several images, use character_refs instead — this URL binds one call, a register entry binds all of them."
    },
    "character_states": {
      "type": "object",
      "description": "Which STATE each character is in for this image, as { characterId: stateKey } — e.g. { \"12\": \"wet\" }. A state is its own asset with its own full descriptor (clean / soaked / bloodied are three assets, not one with a note), and it is the ONLY way that descriptor reaches a generation: the reference image always carries the BASE state, so without this field you get dry Cal in a scene where he just came out of the Thames — and the image looks correct. Get the keys from lab_get_character_sheet; create one with the character state endpoint. Every id here must also appear in character_refs (who is not in the frame is not described), and an unknown key is rejected before any quota is spent.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "dreamer_signatur": {
      "type": "string",
      "description": "Proof from the Dreamer (lab_prompt_transform, or the dreamer_fassung of a previous call) that THIS prompt went through it. Without a valid one the tool does not generate: it runs the Dreamer and returns its version first."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "character_id"
  ],
  "properties": {
    "views": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which views to render. Omit for the core views (six for humans, five without costume for tier/kreatur). Allowed: detail, frontal, profile, fullbody, fullbody_back, costume, pose_sitting, pose_walking, pose_action. Fewer views = fewer credits; `detail` and `fullbody` alone are usually enough to lock an identity."
    },
    "get_cost": {
      "type": "boolean",
      "description": "Free: the exact price of this run (per view and total, anchor and edit rate included) — nothing is rendered or charged. Name it to the person before the real run."
    },
    "character_id": {
      "type": "string",
      "description": "Character sheet id (from lab_list_characters or lab_create_character) — positive integer as string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "prompt"
  ],
  "properties": {
    "tool": {
      "enum": [
        "elevenlabs_music",
        "stable_audio"
      ],
      "type": "string",
      "description": "Music engine. Default 'elevenlabs_music' (ElevenLabs Music v2.5, per second, 3-300 s). 'stable_audio' is the older flat-priced engine (1-190 s)"
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "What the music should be. Name genre, instrumentation, mood AND the tempo in bpm if the cut is supposed to sit on the beat — e.g. 'driving techno, four-on-the-floor kick, 128 bpm, no vocals'. A prompt without a stated pulse is the usual reason lab_beatgrid comes back unreliable"
    },
    "get_cost": {
      "type": "boolean",
      "description": "`true` preflights the credit price and your balance WITHOUT generating anything and without spending quota."
    },
    "scene_ref": {
      "type": "string",
      "description": "Optional scene label, stored on the row. Useful to tell several tracks of one project apart"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    },
    "duration_seconds": {
      "type": "number",
      "maximum": 300,
      "minimum": 1,
      "description": "Track length in seconds (default 30). ElevenLabs takes 3-300 s (shorter is raised to 3), Stable Audio up to 190 s. Make it at least as long as the sequence you want to cut — lab_apply_rhythm computes durations for the clips that exist and neither adds nor deletes any, so a short track under a long timeline stays a short track"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "image_id"
  ],
  "properties": {
    "hue": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Hue rotation in degrees; zero neutral"
    },
    "look": {
      "type": "string",
      "description": "Named look from the bundle catalogue (e.g. filmlab-neutral, filmlab-warm, filmlab-cool, filmlab-soft, filmlab-punch) — a hand-authored LUT, applied on top of the sliders. The server resolves the name; a path is never accepted."
    },
    "grain": {
      "type": "number",
      "maximum": 30,
      "minimum": 0,
      "description": "Film grain amount; zero is none, monochrome"
    },
    "curves": {
      "type": "object",
      "required": [
        "rgb",
        "r",
        "g",
        "b"
      ],
      "description": "Curves per channel as [x, y] points 0..255, x strictly increasing (smooth monotone curve through them). Example warm highlights: {\"r\": [[0,0],[192,205],[255,255]], \"b\": [[0,0],[192,180],[255,255]]}. Not together with contrast on the rgb channel",
      "propertyNames": {
        "enum": [
          "rgb",
          "r",
          "g",
          "b"
        ],
        "type": "string"
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "array",
          "items": {
            "type": "number",
            "maximum": 255,
            "minimum": 0
          },
          "maxItems": 2,
          "minItems": 2
        },
        "maxItems": 16,
        "minItems": 2
      }
    },
    "levels": {
      "type": "object",
      "required": [
        "rgb",
        "r",
        "g",
        "b"
      ],
      "description": "Levels per channel (rgb = all three, r/g/b single), values 0..255: input black/white point, gamma (above 1 brightens midtones), output black/white. Example: {\"rgb\": {\"black\": 12, \"white\": 240, \"gamma\": 1.1}}",
      "propertyNames": {
        "enum": [
          "rgb",
          "r",
          "g",
          "b"
        ],
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "black": {
            "type": "number",
            "maximum": 254,
            "minimum": 0
          },
          "gamma": {
            "type": "number",
            "maximum": 10,
            "minimum": 0.1
          },
          "white": {
            "type": "number",
            "maximum": 255,
            "minimum": 1
          },
          "out_black": {
            "type": "number",
            "maximum": 255,
            "minimum": 0
          },
          "out_white": {
            "type": "number",
            "maximum": 255,
            "minimum": 0
          }
        }
      }
    },
    "contrast": {
      "enum": [
        "high",
        "low"
      ],
      "type": "string",
      "description": "Contrast curve: high is an S-curve, low flattens it"
    },
    "exposure": {
      "type": "number",
      "maximum": 3,
      "minimum": -3,
      "description": "Exposure in stops; positive brightens, zero is neutral"
    },
    "image_id": {
      "type": "string",
      "description": "Id of the source image in the project gallery (from lab_list_assets / lab_generate)"
    },
    "lightness": {
      "type": "number",
      "maximum": 100,
      "minimum": -100,
      "description": "Lightness; negative darkens, zero neutral"
    },
    "grain_mono": {
      "type": "boolean",
      "description": "Grain in black and white (default true); false gives colour grain"
    },
    "grain_seed": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Seed of the grain pattern (default 0) — same seed, same grain"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects)"
    },
    "saturation": {
      "type": "number",
      "maximum": 100,
      "minimum": -100,
      "description": "Colour saturation; minimum is greyscale, zero neutral"
    },
    "gradient_map": {
      "type": "object",
      "required": [
        "stops"
      ],
      "properties": {
        "stops": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "number",
                  "maximum": 1,
                  "minimum": 0
                },
                {
                  "type": "string",
                  "pattern": "^#[0-9a-fA-F]{6}$"
                }
              ]
            },
            "maxItems": 2,
            "minItems": 2
          },
          "maxItems": 8,
          "minItems": 2
        },
        "opacity": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        }
      },
      "description": "Gradient map: luminance 0..1 → colour ramp, blended with opacity (default 1). Example teal-orange: {\"stops\": [[0, \"#0b2a33\"], [0.5, \"#7a7a72\"], [1, \"#ffd9a8\"]], \"opacity\": 0.3}"
    },
    "look_opacity": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Blend of the named look, 0..1 (default 1)"
    },
    "from_colorist": {
      "type": "boolean",
      "description": "Start from the project's colorist crew brief (look/contrast/grain), then apply the sliders on top"
    },
    "exposure_gamma": {
      "type": "number",
      "maximum": 10,
      "minimum": 0.1,
      "description": "Exposure gamma; 1 neutral, above 1 brightens midtones"
    },
    "exposure_offset": {
      "type": "number",
      "maximum": 0.5,
      "minimum": -0.5,
      "description": "Exposure offset added after the stops (lifts or crushes blacks); zero neutral"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "seq_id"
  ],
  "properties": {
    "grade": {
      "type": "object",
      "description": "Fields to set — see description; omit to list clips and grades",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "seq_id": {
      "type": "string",
      "description": "Sequence id — positive integer as string (lab_list_sequences)"
    },
    "clip_id": {
      "type": "string",
      "description": "The clip to grade (from the listing); omit with programm:true"
    },
    "programm": {
      "type": "boolean",
      "description": "Grade the whole programme instead of one clip"
    },
    "zuruecksetzen": {
      "type": "boolean",
      "description": "Start from a neutral grade before applying `grade`"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "What the element shows — the OBJECT or the PERSON, not the scene around them. The backend appends an isolation clause (single subject, plain seamless background, even light) so the cut-out has a clean edge; describing a set as well fights that clause and produces an element that cannot be freed."
    },
    "get_cost": {
      "type": "boolean",
      "description": "Preflight: return the price in credits and your balance WITHOUT generating and without spending anything. There is no model to pick on this path — the cut-out runs on the house image model and is billed at the plain image rate, so lab_list_models has no entry that would change this number; it comes from the same cost endpoint as everywhere else."
    },
    "metadata": {
      "type": "object",
      "description": "Free-form JSON stored alongside the element (e.g. { note, parent_id }). Merged into the row's metadata next to the fields the pipeline sets itself (kind, layer_type, status) — not interpreted.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "scene_ref": {
      "type": "string",
      "description": "Scene label (e.g. 'SZ 04'). Stored on the row, so the element can be matched back to a shot list and reviewed per scene with lab_review_queue. Omit it and the element is an orphan in the gallery."
    },
    "layer_type": {
      "enum": [
        "cast",
        "prop",
        "foreground",
        "background",
        "stage",
        "crowd"
      ],
      "type": "string",
      "description": "Which kind of element this is — it picks the isolation clause: 'cast' full-body person, 'prop' single object, 'foreground' a foreground piece, 'background' a wide backdrop plate WITHOUT people, 'crowd' one background performer head to feet. 'stage' is accepted by the backend but has no clause of its own and falls back to the generic one. Omit for the backend default ('prop')."
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string. Travels in the URL; the element is filed in this project's gallery."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "kind"
  ],
  "properties": {
    "eu": {
      "type": "boolean",
      "description": "Only models allowed in EU mode projects (data stays inside the EU data path). Every model carries `eu_modus` and, where false, `eu_grund` — the first missing proof (`form: knapp` carries only `eu_modus`)"
    },
    "ton": {
      "enum": [
        "mit",
        "ohne"
      ],
      "type": "string",
      "description": "ohne = can run without sound (audio nie or schaltbar); mit = can make sound"
    },
    "kind": {
      "enum": [
        "video",
        "image"
      ],
      "type": "string",
      "description": "Which catalog"
    },
    "voll": {
      "type": "boolean",
      "description": "Every field of every model even without klasse — large, use a filter with it"
    },
    "klasse": {
      "type": "string",
      "description": "Only one capability class — the valid names are listed under `klassen` in every answer"
    },
    "dauer_s": {
      "type": "number",
      "description": "Only models that can render this duration in seconds",
      "exclusiveMinimum": 0
    },
    "aufloesung": {
      "type": "string",
      "description": "Only models offering this resolution, e.g. 540p"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "image_id"
  ],
  "properties": {
    "engine": {
      "enum": [
        "fal-sam3d",
        "vggt",
        "vggt-splat"
      ],
      "type": "string",
      "description": "Which reconstruction path. Omit for the backend default. 'vggt' is scene-scale and fast but gives a point cloud; 'vggt-splat' trains a walkable Gaussian splat from the same scan (minutes on a GPU, not seconds). Both need their own model configured on the backend — where it is not, the answer says so instead of falling back silently."
    },
    "image_id": {
      "type": "string",
      "description": "Id of the SCAN row (from lab_list_location_scans) — positive integer as string. It is a row in the image gallery whose tool is the location scanner; a normal generated image with that id is rejected, not reconstructed."
    },
    "max_photos": {
      "type": "integer",
      "maximum": 64,
      "minimum": 0,
      "description": "How many keyframes are pulled from the clip and handed to the reconstruction. Omit to let the engine use its own count — more frames mean a wider parallax baseline and a slower run."
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string. The scan must belong to it; a scan of another project is not found rather than borrowed."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "name": {
      "type": "string",
      "description": "zusammensetzen: title of the new sequence"
    },
    "plan": {
      "type": "object",
      "required": [
        "dauer_s",
        "original_kamera",
        "personen",
        "einstellungen"
      ],
      "properties": {
        "look": {
          "enum": [
            "gleich",
            "kino"
          ],
          "type": "string",
          "description": "gleich: keep the original look. kino: re-shoot it like a film (needs kino_kopf)"
        },
        "bilder": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "One job per extra reference image, e.g. 'how the woman looks'. Same order as bild_urls"
        },
        "dauer_s": {
          "type": "number",
          "description": "Length of the clip in seconds",
          "exclusiveMinimum": 0
        },
        "personen": {
          "type": "string",
          "description": "Who is in the clip, half a sentence — for naming only, no character paragraphs"
        },
        "kino_kopf": {
          "type": "string",
          "description": "Cinematic header key from aktion optionen"
        },
        "einstellungen": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "von_s",
              "bis_s",
              "groesse",
              "kamera_ort"
            ],
            "properties": {
              "bild": {
                "type": "string",
                "description": "Optional: one short sentence on what we see"
              },
              "bis_s": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "von_s": {
                "type": "number",
                "minimum": 0
              },
              "zeile": {
                "type": "string",
                "description": "The words spoken during this shot, verbatim — the cut lands on them"
              },
              "groesse": {
                "type": "string",
                "description": "Shot size key from aktion optionen"
              },
              "kamera_ort": {
                "type": "string",
                "description": "Where the camera physically stands in ONE sentence — side, height, distance, by landmarks"
              }
            }
          },
          "description": "The shot list, in order, covering the clip without gaps"
        },
        "anfang_behalten": {
          "type": "boolean",
          "description": "The first shot stays identical to the original"
        },
        "original_kamera": {
          "type": "string",
          "description": "The ORIGINAL angle in physical words: where the camera stands, its height, what it points at. The prompt forbids exactly this"
        }
      }
    },
    "tool": {
      "type": "string",
      "description": "Model key from aktion optionen (only models that take a clip as reference). Default: the first one listed there"
    },
    "preis": {
      "type": "boolean",
      "description": "Also price all pieces (free, books nothing)"
    },
    "aktion": {
      "enum": [
        "optionen",
        "plan",
        "zusammensetzen"
      ],
      "type": "string",
      "description": "optionen: models with their limits, shot sizes, cinematic headers (free, no project needed). plan (default): check the shot list and build the runs. zusammensetzen: finished pieces into one new sequence"
    },
    "bild_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Image addresses for plan.bilder, same order"
    },
    "laengen_s": {
      "type": "array",
      "items": {
        "type": "number",
        "exclusiveMinimum": 0
      },
      "description": "zusammensetzen: the planned length of each piece (stuecke[].bis_s - von_s), same order"
    },
    "video_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "zusammensetzen: the finished pieces, in order"
    },
    "project_id": {
      "type": "string",
      "description": "Project — required for plan and zusammensetzen"
    },
    "rechte_bestaetigt": {
      "type": "boolean",
      "description": "The person confirmed they hold the rights to an uploaded clip — passed into every run"
    },
    "reference_video_url": {
      "type": "string",
      "description": "The clip to re-shoot: an uploaded file (lab_add_media / lab_list_assets) or a finished clip of this project"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompt"
  ],
  "properties": {
    "mode": {
      "enum": [
        "beautify",
        "storyboard",
        "polish",
        "format",
        "shorten",
        "expand",
        "simplify",
        "custom",
        "stiluebernahme"
      ],
      "type": "string",
      "description": "Default beautify (generates). beautify: Aus der Idee einen vollständigen Prompt bauen — ergänzt Licht, Optik, Kamera, Stimmung | storyboard: Szene in 4–8 nummerierte Panels zerlegen — je Panel ein eigenständiger Bild-Prompt | polish: Wortwahl polieren, Flow verbessern, Redundanz entfernen — Länge bleibt | format: In // Subject // Lighting // Camera Sektionen ordnen, Wortlaut bleibt | shorten: ~30% kürzer, jedes Wort muss Gewicht tragen | expand: Texturen, Lichtreflexe, atmosphärische Details | simplify: Direkt und klar, weniger Fachjargon | custom: Eigene Anweisung — z.B. 'Mach es düsterer' | stiluebernahme: Licht, Optik und Look aus einer Beschreibung — Motiv und Bildaufbau bleiben wörtlich"
    },
    "tool": {
      "type": "string",
      "description": "Optional: the model you will render with, as the registry key from lab_list_models. Decides which family skeleton lays out camera, lens and light — and whether it is a measured rule or the plain appended form."
    },
    "depth": {
      "enum": [
        "sketch",
        "skeleton"
      ],
      "type": "string",
      "description": "video only: sketch (5 blocks, default) or skeleton (15 blocks)"
    },
    "anlass": {
      "enum": [
        "frei",
        "interview",
        "szene",
        "portrait",
        "street",
        "editorial",
        "handy"
      ],
      "type": "string",
      "description": "beautify only: what the image is FOR. Default frei"
    },
    "medium": {
      "enum": [
        "photo",
        "video"
      ],
      "type": "string",
      "description": "photo (default) or video — decides the section layout"
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "The text to work on — a loose thought is enough for beautify"
    },
    "winkel": {
      "type": "string",
      "description": "Optional: change the camera angle of the EXISTING prompt — a key such as augen, unter, auf, vogel, frosch, schraeg, ots, pov, profil. Implies mode=custom and needs no instruction; combinable with groesse."
    },
    "familie": {
      "type": "string",
      "description": "Optional, instead of tool: the model family by name when no registry key is at hand. Medium decides whether the image or the video skeleton applies."
    },
    "groesse": {
      "type": "string",
      "description": "Optional: change the shot size of the EXISTING prompt, keeping subject, light and place — a key such as ews, ws, mws, ms, mcu, cu, ecu, macro. Implies mode=custom and needs no instruction. An unknown key is rejected with the known ones."
    },
    "techniken": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 3,
      "description": "Up to three directing technique keys from lab_regie_techniken. Their prompt fragments are appended verbatim after the transform, ordered angle, framing, composition, movement. One angle and one movement at most; movement only with medium=video."
    },
    "project_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Optional: the project this prompt is for. With tool or familie, its Lens Lab optics, Pose Director framing and gaffer light are laid into the prompt. If the project has look_in_post on and a Lens Lab set chosen, grain, halation, vignetting, chromatic aberration and edge softness are left out — the FilmLab Look plugin adds them in Resolve; the answer lists what was removed."
    },
    "referenzen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "art"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The reference as an ID — optional here for the same reason."
          },
          "art": {
            "enum": [
              "bild",
              "video",
              "ton"
            ],
            "type": "string",
            "description": "Which channel this reference goes into: bild an image, video a clip, ton a sound."
          },
          "url": {
            "type": "string",
            "description": "Address of the reference — optional here: the Dreamer only needs the ORDER and the channel, not the file."
          },
          "rolle": {
            "type": "string",
            "description": "WHICH character or place this reference means. Carried into the mapping the answer returns."
          }
        }
      },
      "description": "The references the prompt may point at, IN THE ORDER you will pass them to lab_animate/lab_propose. Write @bild1, @video1, @ton1 in your prompt and they come back as the markers the model actually reads (@Image1, @Video2, @Audio1) — the reference clip itself is @Video1, so the first video reference is @Video2. A mention with no matching reference is rejected instead of being left in the text, where it would reach the model as a word."
    },
    "instruction": {
      "type": "string",
      "description": "Required for custom (an order, e.g. 'make it darker') and stiluebernahme (a style description)"
    },
    "location_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Optional, only with tool or familie: the location board whose prompt prefix becomes the place block — the same board you will hand to lab_animate/lab_generate."
    },
    "duration_seconds": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "video only: the clip length in seconds the ACTION TIMING beats are written to. Default 5 (what lab_animate renders without an explicit duration). Rejected for medium=photo."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "kind",
    "project_id",
    "prompt"
  ],
  "properties": {
    "kind": {
      "enum": [
        "video",
        "image"
      ],
      "type": "string",
      "description": "Which kind of generation to propose"
    },
    "tool": {
      "type": "string",
      "description": "Model id, copied verbatim from lab_list_models. Omit to use the default for this kind — the card names it and prices it either way."
    },
    "in_sec": {
      "type": "number",
      "description": "Video: start of the excerpt cut out of the reference clip, in seconds. Only together with out_sec and source_video_id."
    },
    "intent": {
      "type": "string",
      "description": "Video intent from the routing rules. Used to choose a model when tool is omitted and retained for Plan B; an explicit tool wins."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "What to generate. The user can edit it on the card; lab_run_proposal takes the edited text as prompt_override without a new proposal. Video only: For a clip of 4 s or longer, write the action as timed beats, one per line under a '// Action Timing' header: '[0-2s] [CAM 01] <framing> -> [ACT] <action> -> [DIAL] <who>: \"<line>\" -> [AUDIO] <sound>'. The spans start at 0 and cover duration_seconds; keep the same CAM number while the camera does not cut. lab_prompt_transform (medium video) writes exactly this form. Murnau's SceneFlow lights each beat while the clip plays, and the crew judges it there."
    },
    "familie": {
      "enum": [
        "seedance-2.0",
        "seedance-2.5"
      ],
      "type": "string",
      "description": "Video: pick the model ('seedance-2.0', 'seedance-2.5') instead of a route — the card then names and prices the route the server takes for this account, and the run is PINNED to it (a card promises one price, so no silent fallback). Mutually exclusive with tool and intent."
    },
    "out_sec": {
      "type": "number",
      "description": "Video: end of the excerpt in the reference clip, in seconds. Must lie behind in_sec."
    },
    "variants": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Image: how many variants (default 1). Multiplies the price — the card shows the multiplication."
    },
    "audio_url": {
      "type": "string",
      "description": "Video: URL of an existing audio track to lay under the clip. Independent of generate_audio."
    },
    "scene_ref": {
      "type": "string",
      "description": "Scene label (e.g. 'SZ 04'). Stored on the row, so the result can be matched back to a shot list."
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects)"
    },
    "referenzen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "art"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The reference as an ID, looked up in this project: an image id, a video id, an audio id, or an asset key. The URL is never built here."
          },
          "art": {
            "enum": [
              "bild",
              "video",
              "ton"
            ],
            "type": "string",
            "description": "Which channel this reference goes into: bild an image, video a clip, ton a sound. How many of each a model takes is in lab_list_models (referenz_grenzen); a channel the model has no slot for is rejected before a card is even offered."
          },
          "url": {
            "type": "string",
            "description": "Address of the reference. Exactly one of url or id."
          },
          "rolle": {
            "type": "string",
            "description": "WHICH character or place this reference means. Free text, carried through."
          }
        }
      },
      "description": "Video, clip path (source_video_id): typed references. The position IS the address — first image @Image1, first extra clip @Video2, first sound @Audio1. Image references are measured before sending and scaled up to the model's minimum rather than rejected."
    },
    "resolution": {
      "type": "string",
      "description": "Resolution tier, exactly as listed for the model in lab_list_models. Omit for the model's default."
    },
    "location_id": {
      "type": "string",
      "description": "Location board id (from lab_list_locations) — anchors the shot in the same place."
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Image: aspect ratio as W:H, from the model's aspect_ratios in lab_list_models."
    },
    "costume_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The costume plate of these characters goes along as an extra reference image — the outfit on an invisible mannequin, NO person. Every id must also be in character_refs. Needs a model whose max_references covers characters + plates. Each plate is one more reference and may cost credits."
    },
    "end_image_id": {
      "type": "string",
      "description": "Video: the completed image to land the clip on (last frame). Only where lab_list_models says supports_end_frame."
    },
    "camera_motion": {
      "enum": [
        "dolly_in",
        "dolly_out",
        "dolly_left",
        "dolly_right",
        "jib_up",
        "jib_down",
        "static",
        "focus_shift"
      ],
      "type": "string",
      "description": "Video: Structured camera move sent to the model itself — only models whose lab_list_models entry lists camera_motions. Prefer this over prose when a keyframe chain must MOVE rather than cross-fade."
    },
    "character_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Character ids (from lab_list_characters) whose reference image locks the cast's identity. Counted against the model's max_references and shown on the card by name."
    },
    "generate_audio": {
      "type": "boolean",
      "description": "Video: ask for the model's native audio. Only meaningful where lab_list_models says audio: schaltbar."
    },
    "seed_image_url": {
      "type": "string",
      "description": "Image: run img-to-img guided by this existing image URL. Shown on the card as the 'before'."
    },
    "source_image_id": {
      "type": "string",
      "description": "Video: the completed image to animate (positive integer as string). Required for a video proposal — unless source_video_id proposes a clip instead."
    },
    "source_video_id": {
      "type": "string",
      "description": "Video: propose a run FROM A CLIP instead of a still — a generated video id (lab_animate/lab_job_status) or an asset key (lab_list_assets). Mutually exclusive with source_image_id; only for models that take a video reference (lab_list_models says v2v)."
    },
    "dreamer_signatur": {
      "type": "string",
      "description": "Dreamer proof (lab_prompt_transform) for THIS prompt. Without it the proposal runs the Dreamer itself and the card shows its version — that card is what the person confirms."
    },
    "duration_seconds": {
      "type": "number",
      "description": "Video: clip length in seconds, inside the model's duration grid from lab_list_models. The card shows the DELIVERED seconds and says so when the provider snaps."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "prompt"
  ],
  "properties": {
    "ton": {
      "enum": [
        "quelle",
        "generiert",
        "keiner"
      ],
      "type": "string",
      "description": "Which sound the result carries. quelle: the reference clip's own audio is laid back under the new picture after generation — the way to keep a spoken take, since models that regenerate audio replace the voice. generiert: keep the model's sound (needs generate_audio: true). keiner: no sound. Omitted: quelle when a reference clip is given and generate_audio is off, generiert when generate_audio is on, keiner otherwise. The finished run reports in metadata what actually lies underneath (ton) and how far picture and sound differ in length (ton_drift_s)."
    },
    "task": {
      "enum": [
        "reference",
        "editing"
      ],
      "type": "string",
      "description": "reference (default): the references guide a new clip. editing: the picture of the reference clip stays and only what the prompt names changes — e.g. 'keep the picture, generate matching sound effects, no music' with generate_audio: true. Needs a reference clip. Edit verbs in the prompt are expected here, not refused."
    },
    "tool": {
      "type": "string",
      "description": "Video model id — copy it verbatim from lab_list_models (kind: video), and only models the catalog marks v2v take a reference clip at all. Omit to let the backend use its own default for this path. Durations, resolutions and price live in the catalog, this text names none."
    },
    "draft": {
      "type": "boolean",
      "description": "Render a cheap DRAFT first (Seedance 2.5 and wan_vace only — other models refuse it before anything is charged). On Seedance 2.5 the draft is 480p, priced at that tier, and carries a draft_id that stays valid for 7 days and only for the account that ordered it. Finish an accepted draft in 1080p ONLY with lab_fertigstellen — never by downloading and re-uploading it: that is a new run with new motion, not the draft. Any `resolution` you pass is ignored for a draft, and the answer says so."
    },
    "in_sec": {
      "type": "number",
      "description": "Cut the reference clip server-side before it reaches the provider: start of the excerpt, in seconds from the clip's beginning. Only together with out_sec."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "What the new clip should show. Describe it — do NOT phrase it as an instruction to edit or extend the reference; some models classify the run by the verb and then reject the aspect ratio and duration after queueing."
    },
    "out_sec": {
      "type": "number",
      "description": "End of the excerpt in the reference clip, in seconds. Must lie behind in_sec; both are set together or neither."
    },
    "get_cost": {
      "type": "boolean",
      "description": "Preflight: return the price in credits and your balance WITHOUT generating and without spending anything, reading the same catalog as lab_list_models. Do this before a long take or when the user should confirm the cost."
    },
    "prop_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Prop ids from lab_list_props (an @prop_ tag in the prompt does the same). Their descriptions go into the prompt; each prop's front view joins the reference images after yours, on free slots only, with its own @Image line (never on wan_vace). The answer says which way it went (props.weg)."
    },
    "use_depth": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "enum": [
            "voll",
            "personen"
          ],
          "type": "string"
        }
      ],
      "description": "Condition the run on a depth pass of the reference clip. Defaults to ON (true = 'voll': depth of the whole frame); pass false to opt out. Models that do not have a depth stage ignore it — the answer says so rather than pretending it happened. 'personen': depth ONLY on the people, the original footage around them — the model stops copying build, hair and clothing of the original performers and the room keeps its colours. With 'personen' the run PAUSES after the mask: only the mask (SAM) is charged, the answer carries cost (mask) and cost_lauf (the run), and the clip waits as wartet_auf_freigabe until the human has looked at the preview (metadata.personen_referenz_url) and you call lab_freigeben. Needs a reference clip and a model with a depth stage; not together with face masks or task='editing'. To RE-FILM a take from new camera angles, pass false: a depth pass locks the geometry of the reference, and the new angles cannot happen. task='editing' ignores it anyway."
    },
    "kamerapfad": {
      "type": "object",
      "description": "The camera move as INPUT instead of prose: an object following shared/kamerapfad/schema.json — poses over time (position, look-at or quaternion, metres, Y up) from the Kadrage terrain flight or drawn by hand, or motion phases as lab_kamerafahrt reads them from a clip (its answer carries a ready `kamerapfad`). The backend validates it, derives phases, and adds the move as a paragraph after your prompt, before the reference markers (the reference clip still leads the motion as the first video reference). WHICH FORM that paragraph takes depends on the model: prose for most families, bracketed director commands for the MiniMax/Hailuo family, which parses them. NO MODEL RECEIVES THE POSES TODAY — the answer says which form went out (kamerapfad.angewandt = als_text or als_regiebefehle), names the family rule and the source it rests on (kamerapfad.sprache), and lists what that form could not carry. If your own prompt already carries bracketed commands, the path is NOT sent on top of them (angewandt = eigene_regie, with kamerapfad.eigene_regiebefehle naming what it found). A `zusammenfassung` inside the path is display only and is NEVER sent — the move is always rebuilt from the phases; if nothing can be built, the answer says angewandt = nicht_ableitbar with the reason, and nothing of the path is in the prompt. Mutually exclusive with kamerapfad_url.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string. On this path it travels in the request BODY, not in the URL, but it is just as required: the new clip is filed under this project."
    },
    "referenzen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "art",
          "url"
        ],
        "properties": {
          "art": {
            "enum": [
              "figur",
              "ort",
              "stil",
              "motion",
              "raum",
              "stimme",
              "clay",
              "kreativ",
              "bild",
              "video",
              "ton"
            ],
            "type": "string",
            "description": "What this reference IS: figur a character, ort a place, stil a look, motion a movement, raum a spatial/white-model pass, stimme a voice, clay an untextured geometry render, kreativ a free creative reference. The last three say only the CHANNEL, for when the role is not the point: bild any image, video any clip, ton any sound. Not every class has a slot on every model, and which ones do changes as models land: the backend answers a class it cannot route with a named rejection that says why, instead of accepting the reference and quietly ignoring it. Nothing is charged for such a rejection."
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "description": "URL of the reference — an image, a clip or a sound file, matching `art`"
          },
          "rolle": {
            "type": "string",
            "description": "WHICH character or place this reference means. Free text, carried through — it is not derivable from `art`, and guessing it would be a claim about the cast nobody made."
          }
        }
      },
      "description": "The typed successor of character_ref_urls: each reference says WHAT it is, so a place or a look no longer has to travel disguised as a character. Since 2026-09-03 it carries all three channels, not just images: motion references ride alongside the reference clip, sound references go into the model's audio slots. The position IS the address — the images are @Image1..n, the reference clip is @Video1 and the extra motion references follow it, the sounds are @Audio1..n. Image references are MEASURED before they are sent and scaled up to the model's minimum if they fall below it; a reference is never rejected for being small. Mutually exclusive with character_ref_urls — two sources for one list means one of them silently loses. What a model takes per channel is in lab_list_models (referenz_grenzen)."
    },
    "resolution": {
      "type": "string",
      "description": "Render resolution on this path, copied verbatim from the model's resolutions in lab_list_models. The run is priced at the resolution you choose — the low tier costs a fraction of the default — so pass it for sound-only or test runs. Omitted, the model's default applies."
    },
    "kamera_frei": {
      "type": "boolean",
      "description": "New camera angles (lab_neue_winkel): @Video1 carries the action, the words and the timing, but NOT the camera — the camera follows the timestamped shot list in the prompt. Replaces the default sentence 'follow the motion, camera movement and timing of @Video1 exactly', which would pull the model back to the original angle. Needs a reference clip and use_depth=false, not with task='editing'. Normally you pass the ready `lauf` object from lab_neue_winkel unchanged instead of setting this by hand."
    },
    "stil_kit_id": {
      "type": "string",
      "description": "Style kit id (lab_list_stil_kits; an @stil_ tag in the prompt does the same). Omit it and the project's default kit applies. Its rules and palette go into the prompt; its images join the reference images AFTER yours and the props, only on slots the model still has free (never on wan_vace, where an image would be read as a character). The answer says which way it went (stil_kit.weg)."
    },
    "wechsel_von": {
      "type": "string",
      "description": "The model id this call switches AWAY from (as listed in lab_list_models), with the same references as before. The answer then carries `wechsel`: which references the switch cuts off and why, and which ones the new model picks up. Nothing is sent to the old model; the field only names the comparison."
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Output aspect ratio on this path, written as width:height or 'auto'. Only models whose lab_list_models entry takes it on the reference path accept it; for any other model the backend refuses it before anything is charged, and the refusal lists the allowed values. Omitted, the model's fixed default applies."
    },
    "ton_fuehrung": {
      "enum": [
        "voll",
        "stimme",
        "keine"
      ],
      "type": "string",
      "description": "What the model HEARS as guidance while it renders — not what the result carries (that is `ton`). voll (default, same as omitting it): unchanged behaviour. stimme: the backend splits the reference excerpt (after in_sec/out_sec) with demucs and sends ONLY the vocal stem, unchanged, as the single audio reference @Audio1 — so a speaking or singing performer moves the lips without the music bed dragging along. The stem is never pitch-shifted or altered in any way. The demucs split is charged per second of the excerpt and shows up in get_cost (ton_fuehrung.cost); it is cached per clip and in/out, a repeat costs nothing. Needs a reference clip and a model with an audio slot; not together with sound references in `referenzen`. keine: no audio reference at all. With ton='quelle' the original mix of the clip — not the stem — is laid back under the result."
    },
    "ohne_stil_kit": {
      "type": "boolean",
      "description": "true switches the project's default style kit off for this one call."
    },
    "generate_audio": {
      "type": "boolean",
      "description": "Let the model generate sound with the clip — only models whose lab_list_models entry can output audio take it on this path. Omitted = no generated sound. Generated audio REPLACES any voice in the reference — to keep a spoken take, leave it off."
    },
    "kamerapfad_url": {
      "type": "string",
      "description": "Address of a kamerapfad JSON instead of the object — the url of a file in THIS project (lab_list_assets), e.g. the kamerapfad JSON that Kadrage writes next to its flight video. Fetched by the backend under the same ownership rule as every reference: a file of another project is a named rejection before anything is charged. Mutually exclusive with kamerapfad."
    },
    "last_frame_url": {
      "type": "string",
      "description": "Guiding frame for the END of the new clip (image URL). Same rule as first_frame_url: wan_vace only, rejected elsewhere rather than dropped."
    },
    "first_frame_url": {
      "type": "string",
      "description": "Guiding frame for the START of the new clip (image URL). Only the wan_vace path binds guiding frames to the provider — with any other model the backend REJECTS this field instead of swallowing it, because a swallowed guiding frame means paying for a run identical to the one without it."
    },
    "dreamer_signatur": {
      "type": "string",
      "description": "Proof from the Dreamer (lab_prompt_transform, or the dreamer_fassung of a previous call) that THIS prompt went through it. Without a valid one the tool does not generate: it runs the Dreamer and returns its version first."
    },
    "duration_seconds": {
      "type": "number",
      "maximum": 30,
      "minimum": 1,
      "description": "Length of the NEW clip. Must lie inside the chosen model's duration grid from lab_list_models — the per-model ceiling is enforced by the backend and rejected rather than silently clamped."
    },
    "raum_beschreiben": {
      "type": "boolean",
      "description": "With depth on, a vision call describes ONLY the room of a still from the reference (place, light, colours, materials — no people) and adds it as a paragraph to the prompt, so a depth run does not come back grey. ON by default; false switches it off. The setting is remembered per project — omit it to use the project's last choice. Skipped automatically when an `ort` reference is given. The answer reports raum.angewandt and the text; metadata.prompt_gesendet holds the prompt as sent."
    },
    "rechte_bestaetigt": {
      "type": "boolean",
      "description": "REQUIRED when the reference clip or a character image was uploaded (not made in FilmLab), including characters whose sheet comes from an uploaded photo. It stands for this statement by the HUMAN: 'Ich habe die Rechte an Bild und Ton dieses Clips und die Einwilligung der gezeigten Personen.' Never set it on your own — show the human the statement and pass true only after they agreed. Without it the backend refuses with rechte_fehlen before anything is charged; get_cost tells you up front (rechte_noetig)."
    },
    "character_ref_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ready image URLs that bind the cast's identity. The name says URLs on purpose: lab_animate's `character_refs` takes character sheet IDS, this path takes ADDRESSES, and the two are not interchangeable. Get them from lab_get_character_sheet. Omit to let the backend use the project's world-bible characters. Mutually exclusive with `referenzen`."
    },
    "reference_video_url": {
      "type": "string",
      "minLength": 1,
      "description": "URL of the clip whose motion is taken. Use the url/video_url a previous answer gave you (lab_list_assets with asset_type 'video', lab_job_status, lab_review_queue) — never a hand-built address: the bucket is not guessable and a wrong one renders and bills into a 404. Leave it out to run on `referenzen` alone (at least one image reference, no `figur`, no in_sec/out_sec, no depth) — the models that allow it carry referenzen_ohne_video in lab_list_models."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ziel",
    "ziel_id",
    "image_id"
  ],
  "properties": {
    "view": {
      "enum": [
        "detail",
        "frontal",
        "profile",
        "fullbody",
        "fullbody_back",
        "costume"
      ],
      "type": "string"
    },
    "ziel": {
      "enum": [
        "figur",
        "location"
      ],
      "type": "string"
    },
    "ziel_id": {
      "type": "string",
      "description": "Character id or location id"
    },
    "ersetzen": {
      "type": "boolean"
    },
    "image_id": {
      "type": "string",
      "description": "Image id from lab_umzug {bilder}, lab_get_job result.bildzeilen or lab_generate"
    },
    "likeness_ref": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Character + reale_person only: Likeness Register id"
    },
    "personenbezug": {
      "enum": [
        "keine_reale_person",
        "reale_person"
      ],
      "type": "string",
      "description": "Character only, REQUIRED there: does the image show a real person?"
    },
    "beschreibung_ableiten": {
      "type": "boolean",
      "description": "Location only"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "type": {
      "enum": [
        "image",
        "video"
      ],
      "type": "string",
      "description": "Which generated rows. Required per project; across projects, omit for both"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max rows (per project default 50). Across projects the page is capped at 20 so next_cursor stays exact"
    },
    "since": {
      "type": "string",
      "description": "ACROSS PROJECTS. created_at >= this ISO-8601 timestamp (e.g. 2026-08-03T00:00:00Z)"
    },
    "until": {
      "type": "string",
      "description": "ACROSS PROJECTS. created_at <= this ISO-8601 timestamp"
    },
    "cursor": {
      "type": "string",
      "description": "ACROSS PROJECTS. The next_cursor of the previous page. Opaque — do not build one by hand"
    },
    "preview": {
      "type": "boolean",
      "description": "Attach the pictures themselves, downscaled to 512px, so a generation run can be SORTED by looking instead of by reading prompts. At most 4 per call — narrow the list with scene_ref/limit rather than expecting more. Rows without an image URL (all videos) are named in preview.notes, not silently dropped."
    },
    "verdict": {
      "enum": [
        "accepted",
        "rejected",
        "pending"
      ],
      "type": "string",
      "description": "PER PROJECT ONLY. Exact verdict filter. Omit to get everything except rejected"
    },
    "scene_ref": {
      "type": "string",
      "description": "PER PROJECT ONLY. Only this scene"
    },
    "tool_used": {
      "type": "string",
      "description": "ACROSS PROJECTS. Exact tool/provider name, e.g. seedance-2.5"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects). Omit to search across all projects"
    },
    "selected_only": {
      "type": "boolean",
      "description": "PER PROJECT ONLY. Only the chosen variants"
    },
    "include_rejected": {
      "type": "boolean",
      "description": "PER PROJECT ONLY. Include rejected in the default listing"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "aktion"
  ],
  "properties": {
    "bpm": {
      "type": "integer",
      "maximum": 180,
      "minimum": 70,
      "description": "Start only: tempo written into the default music prompt (default 120)"
    },
    "thema": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Start only: theme or setting for the gags, e.g. 'big city at night'"
    },
    "aktion": {
      "enum": [
        "preis",
        "weiter",
        "stand",
        "abbrechen"
      ],
      "type": "string",
      "description": "preis: price per item; weiter: one step; stand: show state; abbrechen: delete the state"
    },
    "anzahl": {
      "type": "integer",
      "maximum": 16,
      "minimum": 8,
      "description": "Number of gags and shots, 8–16 (default 10)"
    },
    "lauf_id": {
      "type": "string",
      "description": "Released auto run (lab_auto_lauf) whose cap pays for the steps — required for paid steps"
    },
    "figur_id": {
      "type": "string",
      "description": "Start only: character sheet id with a reference image — positive integer as string"
    },
    "get_cost": {
      "type": "boolean",
      "description": "Same as aktion preis — nothing is generated or charged"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    },
    "situationen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "bild_en",
          "bewegung_en"
        ],
        "properties": {
          "bild_en": {
            "type": "string",
            "maxLength": 4000,
            "minLength": 1,
            "description": "English still prompt: one moment, one action"
          },
          "bewegung_en": {
            "type": "string",
            "maxLength": 1000,
            "minLength": 1,
            "description": "English motion with a strong movement verb"
          }
        }
      },
      "maxItems": 16,
      "minItems": 8,
      "description": "Start only: your own gags instead of suggested ones (e.g. picked from lab_situationen)"
    },
    "musik_prompt": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1,
      "description": "Start only: music prompt; default is an instrumental groove with a steady beat"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "vorschlag_id"
  ],
  "properties": {
    "vorschlag_id": {
      "type": "string",
      "description": "The id from lab_propose or plan_b in lab_job_status. Do not construct one — an unknown id answers 'vorschlag_abgelaufen', not an error you can work around."
    },
    "ohne_keyframe": {
      "type": "boolean",
      "description": "Skip the keyframe checkpoint on purpose. By default a paid clip only starts from a start image the user has approved (lab_review_asset verdict: accepted) — look at the frame first, then spend on the clip. Set true only when the user explicitly asked to skip the frame check."
    },
    "prompt_override": {
      "type": "string",
      "minLength": 1,
      "description": "Replace ONLY the prompt text of the stored proposal. Every other parameter — model, resolution, duration, references — and the price stay exactly as shown. This is the path for a prompt the user edited on the card: the price does not depend on the text, so no new proposal is needed. Standbild-Bewegung uses no model prompt; confirm that proposal unchanged. An edited text goes through the Dreamer first: without a matching dreamer_signatur the call does NOT run, the proposal stays valid, and the answer carries the Dreamer version to confirm."
    },
    "dreamer_signatur": {
      "type": "string",
      "description": "Dreamer proof for prompt_override (from the previous answer's dreamer_signatur)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "art"
  ],
  "properties": {
    "art": {
      "enum": [
        "sfx",
        "ambience",
        "dialog",
        "voiceover",
        "foley",
        "denoise",
        "split",
        "isolation"
      ],
      "type": "string",
      "description": "Kind of track — sfx (a single sound effect), ambience (a continuous atmosphere/soundscape), dialog (a spoken line), voiceover (narration), foley (sound derived FROM an existing clip and synced to what happens in it — needs `video_id`, ignores `duration_seconds`, and takes its length from the source). The repair kinds work on a recording you already have and need exactly one source (`audio_id`, `video_id` or `audio_url`), never a prompt: denoise (take out hiss, hum and room noise), split (separate the recording into stems — one audio row per stem), isolation (keep only the voice, drop room, noise and music). Their length follows the source, so `duration_seconds` is ignored. Not 'music' — that stays lab_generate_music, it binds a different stem"
    },
    "stems": {
      "type": "array",
      "items": {
        "enum": [
          "vocals",
          "drums",
          "bass",
          "other",
          "guitar",
          "piano"
        ],
        "type": "string"
      },
      "description": "SPLIT ONLY: which parts to separate out. Left out, you get the voice and the rest of the recording, each part as its own audio row. Asking for a subset drops what you leave out — there is no combined everything-but-the-voice file, that would be a mixdown the provider never made."
    },
    "prompt": {
      "type": "string",
      "description": "What the sound should be. For sfx/ambience: name the source and character of the sound. For dialog/voiceover: the line or text to speak. Required for every art EXCEPT foley — foley watches the clip, so leaving it empty means 'take what you see', and a prompt merely steers it"
    },
    "audio_id": {
      "type": "string",
      "description": "REPAIR KINDS ONLY, and the best of the three ways to name a source: an existing audio row of this project (from lab_list_audio), which has an owner and an address that belongs to us. Chain it — denoise a row, then split the result. The row must already carry an audio_url; a pending one has no file yet."
    },
    "get_cost": {
      "type": "boolean",
      "description": "`true` reports the price and your balance WITHOUT generating anything and without spending quota. Not drawn from the lab_list_models catalog (that covers image/video models only) — audio pricing follows the provider FilmLab picks for `art`, and each kind is billed by its own unit: per run, per second, or per character. For the spoken kinds the price follows the length of your text, which the cost endpoint cannot take: the answer then names the provider and your balance and reports `cost_generations` as null rather than inventing a number — the real amount comes back with the call."
    },
    "video_id": {
      "type": "string",
      "description": "The clip to work from. For FOLEY it is required to RUN one; for the repair kinds it is one of the three ways to name a source, and the backend extracts the audio track from it. From lab_list_assets or the row an animate call returned; the clip must belong to this project. The backend measures its length and rejects sources it will not process, before anything is charged. A price question (`get_cost: true`) does NOT need it — the price follows a length, not a particular clip."
    },
    "audio_url": {
      "type": "string",
      "description": "REPAIR KINDS ONLY, and the last resort: a bare address of a sound file. It carries no owner, so nothing can be checked against the project — prefer `audio_id` or `video_id`. A provider address is copied into our own storage first, and if that fails the call is refused rather than stored with a deadline."
    },
    "scene_ref": {
      "type": "string",
      "description": "Optional scene label, stored on the row. Useful to tell several tracks of one project apart"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    },
    "duration_seconds": {
      "type": "number",
      "maximum": 600,
      "minimum": 0.5,
      "description": "Desired length in seconds. The backend clamps this to what the chosen provider actually supports for this `art` — dialog/voiceover ignore it entirely, the length follows the text, and foley ignores it too, its length follows the clip. The repair kinds ignore it as well: you clean up a file, not a stretch of it. One exception, and only for asking: in a `get_cost` query on foley or a repair kind, naming it prices THAT length instead of the ceiling. There is no lab_list_models entry for audio: the provider isn't a choice you make here, it's picked automatically per `art`."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "sequence_id"
  ],
  "properties": {
    "profile": {
      "enum": [
        "web",
        "social_vertical",
        "social_youtube",
        "streaming_hdr",
        "cinema",
        "master",
        "alpha_prores4444",
        "alpha_png_sequence"
      ],
      "type": "string",
      "description": "Delivery profile (default 'web'). See lab_export_profiles. 'alpha_prores4444' and 'alpha_png_sequence' keep transparency and are refused with an explanation unless a clip in the sequence really carries an alpha channel."
    },
    "quality": {
      "enum": [
        "draft",
        "standard",
        "high"
      ],
      "type": "string",
      "description": "Quality preset (default 'standard')"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects)"
    },
    "derivatives": {
      "type": "array",
      "items": {
        "enum": [
          "9x16"
        ],
        "type": "string"
      },
      "description": "Extra cut-downs rendered from the FINISHED export, on top of the main file. '9x16' is a deterministic crop of the wide render into portrait — what falls outside the portrait frame is gone, not filled in. Their URLs arrive in the completed job's `derivatives`."
    },
    "sequence_id": {
      "type": "string",
      "description": "Sequence id to render (positive integer as string, e.g. '27')"
    },
    "ohne_clipton": {
      "type": "boolean",
      "description": "Leave the clips' OWN audio out of the export (e.g. a video model whose sound is always on) — the film then sounds only from the bound stems and the mixdown (music bed, narrator). Default false: the clips' own audio is mixed under the bed as before."
    },
    "include_stems": {
      "type": "boolean",
      "description": "Also export audio stems separately (default false)"
    },
    "ki_kennzeichnung": {
      "enum": [
        "minimal",
        "durchgehend",
        "anfang",
        "abspann",
        "leitfaden"
      ],
      "type": "string",
      "description": "How the visible AI disclosure (EU AI Act Art. 50(4)) appears when the sequence contains AI material. Default 'minimal': a small 'KI' mark in the corner for the whole film. 'durchgehend': the larger 'KI-verändert' box. 'leitfaden': an 'AI' mark top right for the whole film, as in the German regulator's (Bundesnetzagentur) transparency guide. 'anfang': the mark for the first 4 s plus a 4 s end card. 'abspann': only the 4 s end card. 'anfang' and 'abspann' require werk_kuenstlerisch=true; there is no option without any disclosure."
    },
    "derivative_region": {
      "enum": [
        "center",
        "left",
        "right"
      ],
      "type": "string",
      "description": "Which part of the wide frame the portrait crop keeps. Default 'center' — pick 'left' or 'right' when the subject stands off to one side, otherwise the crop cuts it in half."
    },
    "werk_kuenstlerisch": {
      "type": "boolean",
      "description": "Confirm the work is artistic, fictional or satirical — only then may the disclosure be limited to the opening or the end card. Set it only when that is true; the choice is recorded with the export."
    },
    "kennzeichnung_umfang": {
      "enum": [
        "film",
        "abschnitte"
      ],
      "type": "string",
      "description": "For a film that mixes people-made material ('eigen', see lab_herkunft) with AI material: 'film' (default) marks the whole film; 'abschnitte' shows the mark only while an AI or undeclared clip is on screen. Only with ki_kennzeichnung minimal, durchgehend or leitfaden. Audio counts too: an AI or undeclared sound track (bed, stems, mixdown) runs under the whole film, so the export then marks the whole film and reports umfang_bestellt. Declare own music or dialogue with lab_add_media(herkunft) or lab_herkunft. A film with no AI clip at all carries no mark either way. The choice and the clip-by-clip origin are recorded in the provenance record."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Title for the sequence created when `sequence_id` is omitted"
    },
    "manifest": {
      "type": "object",
      "required": [
        "clips"
      ],
      "properties": {
        "bett": {
          "type": "object",
          "required": [
            "pegel_db",
            "fade_s"
          ],
          "properties": {
            "url": {
              "type": "string",
              "description": "Direct URL of the bed (external). A signed FilmLab asset URL is turned into its storage key, so it does not expire inside the sequence"
            },
            "fade_s": {
              "type": "number",
              "maximum": 30,
              "minimum": 0,
              "description": "Fade in and out of the bed"
            },
            "audio_id": {
              "type": "string",
              "description": "Id of an audio row in this project (from lab_list_audio). One of audio_id, asset_key, url"
            },
            "pegel_db": {
              "type": "number",
              "maximum": 6,
              "minimum": -60,
              "description": "Bed level relative to the clips"
            },
            "asset_key": {
              "type": "string",
              "description": "Storage key of an audio file in this project (from lab_add_media or lab_list_assets). Stable — prefer it over a URL: the URLs lab_list_assets hands out are signed and expire after 24 h"
            }
          },
          "description": "A bed under the whole cut. Stored on the sequence; the Resolve bridge places the clip but can set neither level nor fade"
        },
        "clips": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "in_s": {
                "type": "number",
                "maximum": 3600,
                "minimum": 0,
                "description": "In point inside the source clip"
              },
              "out_s": {
                "type": "number",
                "maximum": 3600,
                "minimum": 0,
                "description": "Out point inside the source clip — must be greater than in_s"
              },
              "clip_id": {
                "type": "string",
                "description": "Identity of an EXISTING clip in this sequence, as read back by this tool or by lab_get_sequence. Pass it whenever you are reworking a cut you read: the clip keeps its track, its in-point in the source and its scene, and every shot bound to it stays bound. Omit it for a clip you are adding — one is assigned"
              },
              "dauer_s": {
                "type": "number",
                "maximum": 300,
                "minimum": 0.1,
                "description": "Length of this clip on the timeline. Required unless you give both in_s and out_s — a clip without a length would silently inherit the backend default, and the sequence duration and the render would drift apart"
              },
              "video_id": {
                "type": "string",
                "description": "Id of a generated video in THIS project (from lab_list_assets). Either this or asset_key"
              },
              "asset_key": {
                "type": "string",
                "description": "Storage key of a clip that has no video row. Either this or video_id"
              }
            }
          },
          "maxItems": 200,
          "minItems": 1,
          "description": "The cut, in cutting order. The order here IS the order on the timeline"
        },
        "uebergang": {
          "type": "object",
          "required": [
            "art",
            "dauer_s"
          ],
          "properties": {
            "art": {
              "type": "string",
              "const": "dissolve",
              "description": "Only 'dissolve' — nothing else is implemented downstream"
            },
            "dauer_s": {
              "type": "number",
              "maximum": 10,
              "minimum": 0.1,
              "description": "Length of each dissolve"
            }
          },
          "description": "One transition kind between ALL clips. Stored on the sequence — but neither the Resolve bridge nor the FilmLab render applies it yet: the cut renders with hard cuts"
        }
      },
      "description": "The cut as one object. Omit it only together with a `sequence_id`, to read back what is stored"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    },
    "sequence_id": {
      "type": "string",
      "description": "Sequence to write into (from lab_create_sequence/lab_list_sequences). Omit to create a new one. Given WITHOUT a manifest, the stored manifest is read back instead of written"
    },
    "erwartete_revision": {
      "type": "string",
      "maxLength": 64,
      "description": "The `revision` you read (from lab_get_sequence or this tool's read-back). The cut is written only if the sequence still has exactly that content — otherwise nothing is written and you get `revision_veraltet` with the current revision: read again, merge, write again. Without it this tool still protects the moment between its own read and write, but not the time since YOU read the sequence."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "video_id",
    "transformation_prompt"
  ],
  "properties": {
    "in_sec": {
      "type": "number",
      "description": "Cut the source server-side before it reaches the provider: start of the excerpt, in seconds. Only together with out_sec. What is billed is the MEASURED length of the cut, not out_sec minus in_sec."
    },
    "out_sec": {
      "type": "number",
      "description": "End of the excerpt, in seconds. Must lie behind in_sec; both are set together or neither."
    },
    "asset_id": {
      "type": "string",
      "description": "R2 asset key of an uploaded video (the `key` from lab_list_assets, asset_type 'video') to transform INSTEAD of the row's own clip. The row from video_id still supplies project and scene; only the pixels come from the asset. The key must belong to that same project."
    },
    "get_cost": {
      "type": "boolean",
      "description": "`true` returns the published rate per unit and your balance WITHOUT transforming and without spending anything — NOT a total. Switch X charges by the MEASURED length of the source, which only the server knows before the run, and it is not priced from the lab_list_models catalog (that covers generation models). The real amount comes back with the actual call."
    },
    "video_id": {
      "type": "string",
      "description": "Generated-video id (from lab_animate/lab_job_status/lab_review_queue) — positive integer as string. ALWAYS required, also together with asset_id: this row anchors the run (project, scene, billing) and the backend answers 404 without it."
    },
    "alpha_mode": {
      "enum": [
        "auto",
        "fill",
        "custom",
        "select"
      ],
      "type": "string",
      "description": "How the subject is cut out from its background. Omit to let the backend decide ('auto'); the other modes fill, take a supplied matte, or work on a selection."
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string",
      "description": "Output tier of the transform. This is Switch X's OWN tier list, not one of the video-model resolutions in lab_list_models — that catalog covers generation models and has no entry for this path. The tier drives the price; omit it for the backend default."
    },
    "transformation_prompt": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 3,
      "description": "What the clip should look like afterwards — light, place, props. The subject and its performance are preserved by the model; describing them again does not help."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "anker": {
      "type": "object",
      "required": [
        "name",
        "image_ids"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 120,
          "minLength": 1
        },
        "image_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 12,
          "minItems": 1
        }
      },
      "description": "Build a look anchor from imported images"
    },
    "bilder": {
      "type": "boolean",
      "description": "true: list the project's imported images"
    },
    "dateien": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          "bytes": {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          },
          "content_type": {
            "type": "string"
          }
        }
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Local files to upload: ZIP archives or single PNG/JPG/WEBP"
    },
    "prompts": {
      "type": "string",
      "maxLength": 200000,
      "minLength": 6,
      "description": "Pasted Midjourney prompts, one per line"
    },
    "quellen": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "key"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "After the PUT: exactly the `quellen` from the previous answer's weiter.argumente"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "video_id"
  ],
  "properties": {
    "faktor": {
      "enum": [
        "2",
        "4"
      ],
      "type": "string",
      "description": "How many times larger, per side. Omit for the smaller one. Whichever you pick, the RESULT has to stay inside the published rate tiers — a source too tall for the factor you asked for is refused by name, with the ceiling in the message, instead of billing a run nobody can price. What the tier costs is in lab_list_models and in the preflight, not here."
    },
    "get_cost": {
      "type": "boolean",
      "description": "`true` returns what upscaling THIS clip costs (`cost_generations`, measured server-side from its length and the height of the RESULT, exactly what the run would charge) plus the published rate per output second per tier and your balance — WITHOUT scaling and without spending anything. For a clip that is still pending there is no total yet: then `cost_generations` is null and `preis_grund` says why. Which tiers are measured and which are catalog values is the same distinction lab_list_models makes."
    },
    "video_id": {
      "type": "string",
      "description": "Generated-video id (from lab_animate/lab_job_status/lab_review_queue) — positive integer as string. The row must already have its clip; a run still pending is refused, and nothing is charged for asking."
    },
    "max_credits": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "The most you agree to pay — pass the amount from get_cost that the person confirmed. If the measured price is higher when the run starts, it is refused before anything is charged."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "image_id",
    "operation"
  ],
  "properties": {
    "box_x": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Box left edge as a fraction of image width (0..1)"
    },
    "box_y": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Box top edge as a fraction of image height (0..1)"
    },
    "prompt": {
      "type": "string",
      "description": "inpaint/replace: what should be seen there instead — required. mask: what should be cut out (e.g. 'the red toolbox') — required. relight: optional, replaces the preset"
    },
    "image_id": {
      "type": "string",
      "description": "Id of the source image in the project gallery (from lab_list_assets / lab_generate)"
    },
    "box_hoehe": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Box height as a fraction of image height"
    },
    "licht_weg": {
      "enum": [
        "kontext",
        "iclight"
      ],
      "type": "string",
      "description": "relight only. kontext (default): only the light changes, scene, people and framing stay. iclight: the background is repainted from the light description — the scenery may change"
    },
    "operation": {
      "enum": [
        "inpaint",
        "replace",
        "relight",
        "mask"
      ],
      "type": "string",
      "description": "inpaint: Die rote Werkzeugkiste wird durch eine Holzkiste auf der Werkbank ersetzt. | replace: Derselbe Weg, andere Absicht: in die Box kommt etwas Neues. | relight: Keine Box: die Lichtrichtung wandert über das ganze Bild. | mask: Keine Box: du beschreibst, was heraus soll, und bekommst die Maske."
    },
    "box_breite": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Box width as a fraction of image width"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects)"
    },
    "light_preset": {
      "enum": [
        "left",
        "right",
        "top",
        "golden_hour",
        "blue_night"
      ],
      "type": "string",
      "description": "relight only. There is no 'bottom' — the server does not carry one"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "name",
    "sample_audio_url"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "A label for this cloned voice, shown in lab_list_voices — needed to tell several clones of one project apart later."
    },
    "get_cost": {
      "type": "boolean",
      "description": "`true` reports the price and your balance WITHOUT cloning anything and without spending quota. A clone is billed per clone (a MiniMax clone costs far more than a Fish clone — ask with get_cost) — the length of the source material does not change it, and the clone is then reusable for as many readings as you like. Not drawn from the lab_list_models catalog (that covers image and video models only); there is no model to pick here."
    },
    "provider": {
      "enum": [
        "minimax",
        "fish_audio"
      ],
      "type": "string",
      "description": "Which voice house clones it. Omit to stay on the default path — an existing workflow does not change vendor just because another one exists. The choice sticks to the voice: whichever house made it is the one that later speaks with it, so lab_voice_tts has no say in this. What each house can do and what it charges is not stated here — lab_list_models carries that."
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — positive integer as string"
    },
    "einwilligung": {
      "type": "boolean",
      "description": "Consent of the person whose voice is being uploaded. Required on the fish_audio path, which refuses without it before anything is charged. This is not the moderation gate: that one reads the label for abuse, this one asserts you are allowed to use this person's voice at all. Do not set it to be rid of the error — set it because the consent exists. Provider capabilities and prices: lab_list_models."
    },
    "likeness_ref": {
      "type": "string",
      "description": "Consent id from the Likeness Register (LK-XXXXX-XXXXX-XXXXX-XXXXX) for the person whose voice this is. When set, the register is checked live (active, purpose voice_synthesis, the project's target markets) and the clone is refused if the consent does not hold. Needed for a real person's voice in a project for children or young people."
    },
    "sample_audio_url": {
      "type": "string",
      "minLength": 1,
      "description": "URL of the source audio or video the voice is cloned from. Needs a real, sufficiently long speech track — material without one is rejected before anything is spent."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "stufe": {
      "enum": [
        "entwurf",
        "voll"
      ],
      "type": "string",
      "description": "'entwurf' = cheap draft, 'voll' = full world (default)"
    },
    "loc_id": {
      "type": "string",
      "description": "Location board id (from lab_list_locations); needs variante"
    },
    "get_cost": {
      "type": "boolean",
      "description": "Free: the exact price of this operation; nothing is built or charged. Name it to the person before the real run."
    },
    "variante": {
      "enum": [
        "day",
        "night",
        "golden_hour",
        "rain",
        "panorama"
      ],
      "type": "string",
      "description": "Which picture of the board: a time variant or its 360° panorama"
    },
    "project_id": {
      "type": "string",
      "description": "Project id (from lab_list_projects) — the world is filed in this project's gallery"
    },
    "text_prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "Optional description of the place; for a board its prompt prefix is used when left out"
    },
    "quell_bild_id": {
      "type": "string",
      "description": "Instead of a board: a finished gallery image of THIS project"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "bis_s": {
      "type": "number",
      "minimum": 0,
      "description": "End of the page; at most 300 s after von_s"
    },
    "von_s": {
      "type": "number",
      "minimum": 0,
      "description": "Start of the page in seconds (default 0)"
    },
    "sprache": {
      "enum": [
        "de",
        "en",
        "fr",
        "es",
        "it",
        "nl",
        "pl",
        "pt",
        "tr",
        "ja",
        "zh",
        "ko"
      ],
      "type": "string",
      "description": "Spoken language (default de) — the same list the backend accepts"
    },
    "audio_id": {
      "type": "string",
      "description": "Audio track id (from lab_list_audio)"
    },
    "video_id": {
      "type": "string",
      "description": "Generated video id — its own soundtrack. Give exactly one of video_id, audio_id, asset_key"
    },
    "asset_key": {
      "type": "string",
      "description": "Storage key of an uploaded sound or video file (from lab_add_media). Needs project_id"
    },
    "project_id": {
      "type": "string",
      "description": "Project the asset_key belongs to — required with asset_key"
    }
  },
  "additionalProperties": false
}