Every tool the server gives your assistant

The Makemancer MCP server lists 77 tools in Claude, Claude Code and Codex, and a ChatGPT set without purchase tools. You never call them by hand: ask in plain words and the assistant picks the tool. This page is generated from the same tool list the server sends, with every parameter.

Generate

  • generate_image

    Generate imageChanges data

    Ask for it like thisMake a product photo of my perfume on travertine, 4:5.

    Parameters (12)
    NameTypeWhat it is
    promptrequiredstringWhat to generate, or the edit instructions when image_url is given.
    modelstringImage model ID. Default image/nano-banana-2.
    image_urlstringSource image to edit (https URL).
    image_urlsstring[]Reference images (https URLs).
    character_idsstring[]Saved Characters for this shot, in order; a one-item array for one Character. Use list_characters for names and ids, then use the exact saved names in prompt. The server adds each identity description and reference image after existing references and states their Image N numbers; do not guess those numbers. All references count toward the model limit; unsupported requests fail before charging.
    aspect_ratiostringOutput shape such as 16:9; allowed values per model in get_model_params.
    size"1:1" | "4:5" | "5:4" | "9:16" | "16:9"Legacy alias of aspect_ratio.
    num_imagesintegerNumber of images to generate (1-4). Each image is its own job, charged one image's price and refunded on its own if it fails; they share one job_id and the card shows them side by side.
    agentic_promptingbooleanOptional prompt rewrite for the selected model. Omit it (default) or set false to preserve the user's wording; set true only when the user wants a model-specific rewrite. Adds a few seconds and costs nothing extra; the result returns the rewritten prompt (and original_prompt), or a warning when the original was kept. Selected Character identity context is appended unchanged either way.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • generate_video

    Generate videoChanges data

    Ask for it like thisAnimate this photo into a 5-second vertical clip.

    Parameters (15)
    NameTypeWhat it is
    promptrequiredstringSubject, action, camera, setting, timing and sound of the clip.
    modelstringVideo model ID. Default video/gemini-omni-flash.
    image_urlstringLiteral first frame (https URL).
    last_frame_urlstringLast frame, for models that support it.
    image_urlsstring[]Reference images that guide but do not become frames.
    character_idstringA saved Character. Its description is added to the prompt and its image is appended to image_urls as a reference, never as a start frame, so it cannot be combined with image_url or last_frame_url. Choose a model that supports image references. It does not select the Character's voice for native video audio. Use list_characters to find ids.
    video_urlsstring[]Reference or source videos.
    audio_urlsstring[]Reference audio, for models that support it.
    durationnumber | stringLength in seconds, e.g. 5 or "5s"; limits per model.
    aspect_ratiostringe.g. 16:9, 9:16, 1:1.
    resolutionstringe.g. 480p, 720p, 1080p; allowed values per model.
    agentic_promptingbooleanOptional prompt rewrite for the selected model. Omit it by default to preserve the user's wording while keeping the provider's own prompt expansion where a model has one. Set true only when the user wants a model-specific rewrite; the result returns the rewritten prompt (and original_prompt), or a warning when the original was kept. Set false for strict wording; it also turns off the provider's prompt expansion. Adds a few seconds and costs nothing extra. Selected Character identity context is appended unchanged either way.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • generate_speech

    Generate speechChanges data

    Ask for it like thisRead this script as a calm narrator.

    Parameters (9)
    NameTypeWhat it is
    textstringText to speak. Some models take dialogue turns in extras instead.
    modelstringSpeech model ID. Default speech/elevenlabs-v4.
    voice_idstringStock voice ID from get_model_params or search_voices. For a cloned or designed voice pass character_id instead.
    character_idstringCharacter with a saved voice for this model (see list_characters). Do not combine with voice_id. In extras.dialogue, a turn may also take character_id.
    voice_option_idstringA saved voice on that Character. Omit to use the preferred voice for the selected model.
    apply_saved_pronunciationsbooleanApply this account's saved pronunciation text replacements for the selected model family. Defaults to true. Set false to bypass saved entries for this request; explicit pronunciation markup in text is preserved.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • generate_music

    Generate musicChanges data

    Ask for it like thisWrite a 20-second acoustic jingle for my brand.

    Parameters (14)
    NameTypeWhat it is
    promptstringGenre, mood, instruments, tempo, structure and vocal role.
    modelstringMusic model ID. Default music/standard.
    lyricsstringCustom lyrics; section tags such as [verse] on their own lines.
    stylestringStyle tags for custom mode.
    titlestringTrack title for custom mode.
    instrumentalbooleanNo vocals. Default false.
    force_instrumentalbooleanAlias of instrumental.
    music_length_msintegerApproximate length in milliseconds (converted to duration in seconds).
    audio_urlstringUploaded source song for music/standard-cover.
    audio_idstringA generated track to extend, cover or edit: audio_id from the tracks of a completed music result.
    task_idstringtask_id from the same tracks entry (the job_id of that result).
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • generate_sound_effect

    Generate sound effectChanges data

    Ask for it like thisMake 4 seconds of rain on a window.

    Parameters (8)
    NameTypeWhat it is
    promptstringThe sound: source, action, space, texture and ending.
    modelstringSound-effect model ID. Default sfx/elevenlabs-sound-v2.
    duration_secondsnumberLength in seconds; omit to let the model choose.
    loopbooleanMake a seamless loop.
    prompt_influencenumberHow closely to follow the prompt, 0 to 1.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.

Edit

  • remove_background

    Remove backgroundChanges data

    Ask for it like thisCut the product out of this photo.

    Parameters (7)
    NameTypeWhat it is
    media_urlrequiredstringImage or video to process (https URL).
    typerequired"image" | "video"Kind of media at media_url.
    modelstringBackground-removal model ID.
    output_format"webm" | "mp4" | "prores"Video only.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • upscale_image

    Upscale imageChanges data

    Ask for it like thisMake this image sharper and bigger.

    Parameters (5)
    NameTypeWhat it is
    image_urlrequiredstringImage to upscale (https URL).
    modelstringImage upscaler model ID.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • upscale_video

    Upscale videoChanges data

    Ask for it like thisUpscale this clip to 1080p.

    Parameters (5)
    NameTypeWhat it is
    video_urlrequiredstringVideo to upscale (https URL).
    modelstringVideo upscaler model ID.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.

Plan and price

  • estimate_generation

    Estimate generation costRead-only

    Ask for it like thisHow much would a 10-second Kling clip cost?

    Parameters (3)
    NameTypeWhat it is
    operation"image" | "video" | "speech" | "audio" | "upscale" | "video_upscale" | "html_video" | "frame_interpolation" | "lip_sync" | "swap_video_characters" | "3d_model" | "video_edit" | "media_import" | "transcribe"Which generation the estimate is for: image, video, speech, audio (music, or a sfx/ model), upscale, video_upscale, transcribe, media_import or html_video (params.method render, or generate / edit for generate_html_video). Optional when model is given. For social URLs, media_import estimates upload_asset with params url, type audio/video, quality and max_duration, and transcribe estimates social caption retrieval including its automatic audio fallback; both read the source length from metadata without downloading and return the full prepaid reservation. frame_interpolation estimates increase_frame_rate (params video_url plus extras target_fps, slowdown_factor) and lip_sync estimates lip_sync_video (params video_url, plus audio_url and model when given). swap_video_characters quotes its price with its free previews, so call it directly.
    modelstringModel ID. Omit to use the default model of the operation.
    paramsobjectThe arguments the generation tool would receive (top-level fields and extras).
  • list_models

    List modelsRead-only

    Ask for it like thisWhich video models can you use?

    Parameters (2)
    NameTypeWhat it is
    category"image" | "video" | "speech" | "audio" | "music" | "sfx" | "upscale" | "background_removal" | "frame_interpolation"Filter by category. Omit to list all.
    querystringFree-text filter on ID, name, description and capabilities.
  • get_model_params

    Get model parametersRead-only

    Ask for it like thisWhat settings does Seedance 2.5 take?

    Parameters (2)
    NameTypeWhat it is
    modelrequiredstringModel ID, e.g. image/nano-banana-2 or video/seedance-2.5.
    include_voice_catalogbooleanAccepted for compatibility; voice IDs are part of the schema.

Jobs and results

  • check_job

    Check jobRead-only

    Ask for it like thisIs my video ready yet?

    Parameters (2)
    NameTypeWhat it is
    job_idrequiredstringjob_id returned by a generation tool (or its first eight characters), a cloud_project_id or a swap session_id.
    words_offsetintegertranscribe: next page of words; pass nextWordsOffset.
  • show_media

    Show mediaRead-only

    Ask for it like thisShow me the last image again.

    Parameters (1)
    NameTypeWhat it is
    itemsrequiredobject[]Media to show; each item has one of asset_id, job_id or url.

Your library and uploads

  • search_assets

    Search assetsRead-only

    Ask for it like thisFind the olive oil photos I made last week.

    Parameters (11)
    NameTypeWhat it is
    type"image" | "video" | "audio" | "document" | "zip" | "project" | "3d_model" | "font"Asset type.
    querystringMatches the asset name (substring), one tag, or the prompt of the generation that made it (substring).
    tagsstring[]Assets with any of these tags.
    namestringExact asset name.
    source"generated" | "uploaded" | "imported"How the asset entered the library.
    created_fromstringCreated at or after this time (ISO 8601).
    created_tostringCreated before this time (ISO 8601).
    limitintegerResults per page.
    offsetintegerResults to skip.
    favorites_onlybooleanNot supported; only false is accepted.
    budget_projectstringOnly generated work in this budget project (its slug, id or name), or "none" for generated work in no budget project. Each result names its budget project when it has one.
  • update_asset

    Update assetDeletes

    Ask for it like thisRename that clip to “launch teaser”.

    Parameters (5)
    NameTypeWhat it is
    idrequiredstringAsset ID.
    namestring | nullNew name; null clears it.
    clear_namebooleanRemove the name.
    tagsstring[]Replaces all tags.
    descriptionstringAccepted for compatibility; not stored.
  • delete_asset

    Delete assetDeletes

    Ask for it like thisDelete the draft video.

    Parameters (1)
    NameTypeWhat it is
    idrequiredstringAsset ID.
  • upload_asset

    Import media from URLChanges data

    Ask for it like thisSave this image link to my library.

    Parameters (8)
    NameTypeWhat it is
    urlrequiredstringPublic direct file URL or supported social post URL to import and store permanently. Social imports return a job ID for check_job.
    namestringAsset name; defaults to the file name.
    tagsstring[]Tags for organizing the asset.
    type"image" | "video" | "audio" | "3d_model" | "zip"Expected type of a direct file; the import fails if the file is another type. Required for a ZIP (zip) or 3D model (3d_model) served with a generic type such as application/octet-stream. For social links, omit for video or use audio for audio-only downloads.
    quality"480p" | "720p" | "1080p"Social video resolution: 480p (default, 1.2 credits per started minute), 720p or 1080p (4.8). Total credits round up once per import. Ignored for type audio.
    max_durationintegerFor social links, reject longer sources before downloading. Default 7200 seconds. This rejects long sources; it does not trim them.
    content_typestringAccepted for compatibility; the type is read from the file. Omit for social links.
    descriptionstringAccepted for compatibility; not stored.
  • get_upload_url

    Get upload URLChanges data

    Ask for it like thisUpload this file from my computer.

    Parameters (8)
    NameTypeWhat it is
    content_typerequiredstringMIME type, e.g. image/png, video/mp4, audio/mpeg, font/woff2, application/zip. With a generic type (application/octet-stream) the filename extension decides.
    typerequired"image" | "video" | "audio" | "3d_model" | "font" | "zip" | "project"Asset type; must match content_type. zip is an ordinary ZIP asset; project is a render_html_video project ZIP, kept private and reused by asset ID.
    bytesintegerExact file size in bytes, when known; it is then part of the signed upload. confirm_upload checks the size limit either way.
    namestringAsset name.
    filenamestringOriginal file name: picks the type when the browser reports a generic content_type (e.g. application/octet-stream for woff2), and is the name when name is omitted.
    tagsstring[]Tags for organizing the asset.
    descriptionstringAccepted for compatibility; not stored.
    purpose"media" | "voice_clone"Use voice_clone for a private voice recording; returns an asset ID for clone_voice, never a public audio URL.
  • confirm_upload

    Confirm uploadChanges data

    Ask for it like this(called after an upload finishes)

    Parameters (1)
    NameTypeWhat it is
    asset_idrequiredstringasset_id returned by get_upload_url.
  • load_image

    Load imageRead-only

    Ask for it like thisLook at the image I just made.

    Parameters (1)
    NameTypeWhat it is
    urlrequiredstringPublic image URL.
  • import_chatgpt_media

    Import ChatGPT attachmentChanges dataChatGPT only

    Ask for it like thisUse the photo I attached.

    Parameters (5)
    NameTypeWhat it is
    media_filerequiredobjectThe ChatGPT file to import.
    namestringAsset name; defaults to the file name.
    tagsstring[]Tags for organizing the asset.
    type"image" | "video" | "audio"Expected type; the import fails if the file is another type.
    purpose"media" | "voice_clone"voice_clone keeps an audio recording private for clone_voice and returns its asset ID, never a public URL.

Account

  • manage_account

    View accountRead-only

    Ask for it like thisWhat did I spend this month?

    Parameters (1)
    NameTypeWhat it is
    section"overview" | "activity" | "settings"Account section to show: overview, activity or settings.
  • get_credits_balance

    Get credit balanceRead-only

    Ask for it like thisHow many credits do I have?

    Parameters (3)
    NameTypeWhat it is
    estimate_type"image" | "video" | "speech" | "audio" | "upscale" | "video_upscale" | "html_video" | "frame_interpolation" | "lip_sync" | "swap_video_characters" | "3d_model" | "video_edit" | "media_import" | "transcribe"Operation to estimate, as in estimate_generation (image, video, speech, html_video…). video_edit needs estimate_model; 3d_model is not available on this server and says so.
    estimate_modelstringModel ID to estimate.
    estimate_paramsobjectArguments of the generation to estimate.
  • submit_feedback

    Submit feedbackChanges data

    Ask for it like thisTell the team the last result had the wrong aspect ratio.

    Parameters (6)
    NameTypeWhat it is
    messagerequiredstringWhat worked, broke, was missing or was confusing.
    categoryrequired"bug" | "generation_quality" | "missing_feature" | "confusing" | "praise" | "other"Kind of feedback.
    sourcerequired"agent" | "user"agent: observed by the assistant; user: the user's own words.
    attemptedTaskstringWhat the user was trying to do.
    toolNamestringTool involved, if any.
    relatedIdsstring[]Related job or asset IDs.

Other

  • add_audio_to_video

    Add Audio To VideoChanges data
    Parameters (8)
    NameTypeWhat it is
    video_urlrequiredstringVideo to put the audio on.
    audio_urlrequiredstringAudio to add, such as narration or music.
    start_offsetnumberSeconds after the video starts when the audio begins. Default: 0.
    audio_mode"replace" | "mix"Default: replace.
    original_volumenumberWith mix: gain of the video's own audio, 0 to 1. Default: 1.
    added_volumenumberWith mix: gain of audio_url, 0 to 1. Default: 1.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • add_speech_pronunciations

    Save speech pronunciationsDeletes
    Parameters (1)
    NameTypeWhat it is
    entriesrequiredobject[]Up to 100 pronunciations to save.
  • add_subtitles

    Add SubtitlesChanges data
    Parameters (17)
    NameTypeWhat it is
    video_urlrequiredstringVideo to caption.
    languagestringISO-639 code, sent only when known. Speech language is detected automatically; this picks the font for Chinese, Japanese or Korean.
    font_namestringExact Google Fonts family name, only when the user names a font; never choose one. Checked for the language's script before charging. Words in a script the font cannot draw use the matching Noto Sans family.
    font_sizeintegerPreferred size in pixels; kept within a safe range for the frame.
    font_weight"normal" | "bold" | "black"Default: bold. A font without the weight uses its nearest one.
    font_color"white" | "black" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta"Default: white.
    highlight_color"white" | "black" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta"Color of the word being spoken, the karaoke cue. Default: white.
    stroke_color"white" | "black" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta"Default: black.
    stroke_widthintegerOutline in pixels, 0 for none. Default: 3.
    background_color"white" | "black" | "red" | "green" | "blue" | "yellow" | "orange" | "purple" | "pink" | "brown" | "gray" | "cyan" | "magenta" | "none" | "transparent"Box behind the text. Default: none.
    background_opacitynumberDefault: 0.7.
    position"top" | "center" | "bottom"Default: bottom.
    y_offsetintegerTop and bottom: inward margin, 20 to 200. Center: pixels below the middle, -200 to 200.
    words_per_subtitleintegerPreferred most words per caption; limited by the frame shape.
    enable_animationbooleanBounce each caption in. Default: false.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • approve_generation

    Approve generationChanges data
    Parameters (4)
    NameTypeWhat it is
    request_idrequiredstringReview request ID.
    expected_versionrequiredintegerThe version shown to the user.
    promptstringThe prompt as edited in the card.
    settingsobjectResolution, duration, aspect ratio and audio as chosen.
  • assemble_film

    Assemble FilmChanges data
    Parameters (5)
    NameTypeWhat it is
    idrequiredstringExisting film project id returned by create_film_project or list_film_projects; never use a placeholder.
    mode"connect" | "cut_end"connect preserves every clip and warns about target overage; cut_end trims the fully assembled output at the target duration.
    video_fit"auto" | "crop" | "pad" | "strict"Fit clips to the first clip's canvas. crop (default) and auto center-crop mismatches; pad preserves the full frame with black bars; strict (only when the user asks for it) refuses clips with a different aspect ratio. Original shot URLs are preserved; completed crops are reused on later assemblies.
    with_narrationbooleanReplace the stitched video's audio with the project's audioUrl narration track, if present. This discards every shot's own audio, and the cut ends with the shorter of the video and narration.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • assign_to_budget_project

    Assign To Budget ProjectChanges data
    Parameters (3)
    NameTypeWhat it is
    budget_projectrequiredstring | nullTarget project's slug, id, or name; null removes the generations from their project.
    job_idsstring[]Generation job ids to move.
    asset_idsstring[]Asset ids; each moves its generation.
  • clone_voice

    Clone voiceDeletes
    Parameters (7)
    NameTypeWhat it is
    audio_asset_idstringPrivate voice recording ID from an upload with purpose voice_clone. Public media assets cannot be used.
    audio_urlstringA publicly downloadable audio link. The original bytes are copied into this account's private voice storage before cloning. Private-network targets and non-audio files are rejected. Prefer audio_asset_id when the recording is already privately uploaded.
    character_idstringExisting Character to receive the cloned voice. Omit to create a reusable voice-only Character automatically.
    character_namestringName for an automatically created voice-only Character. Used only when character_id is omitted; defaults to "My Voice".
    consentbooleanPass only with audio_asset_id or audio_url, as true after the user agreed to the consent statement: the recording is their own voice or the speaker explicitly permitted cloning and speech generation. Omit it when calling without a recording.
    languagestringSource recording language code, such as en, es, or he.
    provider"elevenlabs" | "cartesia" | "fish"Voice provider. Here only fish is connected and it is the default; providers are never switched silently, so cartesia or elevenlabs is refused.
  • create_budget_project

    Create Budget ProjectChanges data
    Parameters (3)
    NameTypeWhat it is
    namerequiredstringDisplay name, e.g. Papercraft Tarot. Unique in the workspace.
    slugstringOptional kebab-case slug. Generated from the name when omitted.
    notesstringOptional notes, such as the client or a purchase order.
  • create_character

    Create CharacterChanges data
    Parameters (9)
    NameTypeWhat it is
    titlerequiredstringCharacter name.
    descriptionstringAppearance, personality, role: added to prompts at generation time.
    image_urlstringReference portrait or character sheet URL: the visual anchor for generate_image and generate_video.
    profile_image_urlstringSmall browsing portrait, stored separately from image_url. If omitted when adding or changing a sheet, a profile portrait is generated asynchronously with normal image credits. For a portrait-only Character, pass the portrait URL as both image_url and profile_image_url.
    voice_modelstringSpeech model of an existing public voice, such as speech/elevenlabs-v4.
    voice_idstringExact public voice ID for voice_model, from get_model_params. This does not create a new voice.
    voice_namestringOptional display name for the saved public voice.
    voice_preview_idstringpreview_id of a design_voice audition to save as a voice of this Character. It becomes a private Fish voice that speaks with speech/fish-drama-3.
    voice_languagestring | nullOptional voice preview language code, such as en, he or es. Null clears it. With a saved voice, setting or changing language generates one short localized preview asynchronously using normal speech credits. Omit to keep the current value; no language means no automatic preview.
  • create_film_project

    Create Film ProjectChanges data
    Parameters (6)
    NameTypeWhat it is
    namerequiredstringShort project title
    briefstringThe user's creative brief / what the film is about
    character_idsstring[]Character ids for the cast (from list_characters)
    theme_idstringBrand theme id
    target_duration_snumberTarget total film length in seconds, up to 60 minutes; shot duration is model-dependent. Fractional values are rounded to the nearest second.
    budget_projectstringTie this film to a budget project (slug, id or name). Its shot clips and assembly count toward it.
  • create_template

    Create TemplateChanges data
    Parameters (13)
    NameTypeWhat it is
    namerequiredstringTemplate name.
    descriptionstringWhat this template is for.
    kind"html" | "generative"Default: html.
    parametersobject[]The {{token}} inputs: name, type, optional default, description and required.
    htmlstringhtml kind: markup with {{token}} placeholders.
    widthintegerhtml kind: default width. Required unless sizes is given.
    heightintegerhtml kind: default height. Required unless sizes is given.
    sizesobject[]html kind: named output sizes; one may set isDefault.
    media_type"image" | "video"generative kind: output type.
    recommended_modelstringgenerative kind: model ID.
    promptstringgenerative kind: prompt with {{token}} placeholders.
    model_paramsobjectgenerative kind: default model parameters.
    reference_asset_idsstring[]generative kind: Library assets passed as references.
  • cut_and_reframe_video

    Cut And Reframe VideoChanges data
    Parameters (12)
    NameTypeWhat it is
    video_urlrequiredstringA video in your Library; import the file first.
    segmentsrequiredobject[]Half-open source ranges in seconds, in playback order.
    widthintegerOutput width, even, 128-1920. Default: 1080.
    heightintegerOutput height, even, 128-1920. Default: 1920.
    fps"24" | "25" | "30" | "50" | "60" | "source"Default: source.
    audio_fade_msnumberFade at each discontinuous audio cut, milliseconds. Default: 30. Above 100 is treated as 100.
    normalize_audiobooleanLevel the whole output. Default: false.
    captionsobjectOptional burned captions.
    namestringName for the result in the Library.
    tagsstring[]Tags for the result.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • delete_character

    Delete CharacterDeletes
    Parameters (2)
    NameTypeWhat it is
    idrequiredstringID of the Character to delete.
    confirmrequiredbooleanSet true only after the user asked to delete this Character. Deletion cannot be undone.
  • delete_film_project

    Delete Film ProjectDeletes
    Parameters (4)
    NameTypeWhat it is
    idrequiredstringFilm project ID to permanently delete.
    confirmbooleanTrue only after the user explicitly confirms deletion of this film.
    delete_mediabooleanAlso delete currently linked owned media, only if explicitly requested. Defaults to keeping media.
    expected_updated_atstringThe project's updatedAt from the preview. Rejects a stale deletion confirmation.
  • delete_speech_pronunciations

    Delete speech pronunciationsDeletes
    Parameters (1)
    NameTypeWhat it is
    idsrequiredstring[]Entry IDs from list_speech_pronunciations.
  • design_voice

    Design voiceChanges data
    Parameters (13)
    NameTypeWhat it is
    promptrequiredstringVoice description, 20 to 2,000 characters: age, accent, timbre, pacing, tone and speaking style.
    textstringAudition script spoken by all three candidates: 1 to 150 characters for Fish. Omit when no script exists yet.
    provider"elevenlabs" | "google" | "fish"Voice Design provider. Only fish is connected here and it is the default; elevenlabs and google are refused rather than switched silently.
    extrasobjectFish controls: seed, language_code (BCP-47), guidance_scale (default 2), instruct_guidance_scale (default 0), speed (0 < speed <= 3, default 1), num_step (1 to 128, default 32). Unsupported controls are ignored. They are also accepted at the top level; extras take precedence.
    language_codestringBCP-47 audition language, such as en-GB or he-IL (same as extras.language_code).
    guidance_scalenumberSame as extras.guidance_scale.
    instruct_guidance_scalenumberSame as extras.instruct_guidance_scale.
    speednumberSame as extras.speed.
    num_stepintegerSame as extras.num_step.
    seedintegerSame as extras.seed.
    character_idstringExisting Character the voice is meant for. It is remembered as the place to save; this call saves nothing.
    character_namestringName of a new Character the voice is meant for, when character_id is omitted. It labels the options and is remembered for saving.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • extract_frames

    Extract FramesChanges data
    Parameters (12)
    NameTypeWhat it is
    video_urlrequiredstringVideo file or finished HLS playlist (.m3u8) to extract frames from.
    modestringtimeline (default), timestamps, single, batch, first, middle or last.
    timestampsnumber[]Exact positions in seconds. Selects timestamps mode.
    positionstringFor single mode: first, middle or last. Default: middle.
    frame_intervalnumberBatch only: take every Nth frame (1-300, not seconds). Default: 12.
    max_framesnumberTimeline 1-24 (default 12); batch 1-500 (default 100).
    output_formatstringBatch or timestamps: png (default), jpg or webp.
    qualitynumberBatch or timestamps with jpg or webp: 1-100. Default: 95.
    start_timenumberTimeline only: start of the section.
    end_timenumberTimeline only: end of the section.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • generate_html_video

    Generate HTML VideoChanges data
    Parameters (12)
    NameTypeWhat it is
    promptrequiredstringThe brief for a new video, or what to change when cloud_project_id is given. Name the user's own assets and their roles; ask the user for media the brief needs and you do not have.
    cloud_project_idstringProject ID from an earlier result. Pass it to change that video; omit it to start a new one.
    durationnumberSeconds, up to 300. Default: 5, or the project's.
    widthintegerEven number, 2-3840. Default: 1920, or the project's.
    heightintegerEven number, 2-3840. Default: 1080, or the project's.
    fpsinteger24, 30 or 60. Default: 30, or the project's.
    format"mp4" | "webm" | "mov"Default: mp4, or the project's.
    effort"light" | "medium" | "high"light for simple changes and basic videos, medium (default) for most, high for complex or polished videos; higher is slower and may cost more. A change keeps the project's effort unless given.
    media_budget_creditsintegerMost credits the agent may spend on generated media this turn (default 200; 0 for none).
    reference_assetsobject[]Files the user supplied or selected (logos, images, audio). Images are shown to the agent; every file can be used in the video.
    project_urlstringPublicly downloadable HTTPS URL of a HyperFrames project ZIP to start a new video from, such as a ZIP URL returned by search_examples({ id }).
    project_asset_idstringLibrary ZIP or project asset to start a new video from. It is unpacked as the starting project.
  • get_film_project

    Get Film ProjectRead-only
    Parameters (1)
    NameTypeWhat it is
    idrequiredstringFilm project id from create_film_project or list_film_projects.
  • get_theme

    Get themeRead-only
    Parameters (1)
    NameTypeWhat it is
    namestringTheme name. If omitted, returns the default theme.
  • import_media

    Upload mediaRead-only
    Parameters (2)
    NameTypeWhat it is
    purpose"media" | "voice_clone"voice_clone: one private voice sample; the card returns audio_asset_id for clone_voice instead of a public URL.
    contextstringWhat the files are for; shown on the card.
  • increase_frame_rate

    Increase frame rateChanges data
    Parameters (5)
    NameTypeWhat it is
    video_urlrequiredstringFinished video to retime.
    modelstringFrame interpolation model ID. Default: frame-interpolation/topaz-apollo.
    extrasobjectModel-specific parameters as listed by get_model_params. They are merged with the top-level fields.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • isolate_audio

    Isolate audioChanges data
    Parameters (3)
    NameTypeWhat it is
    audio_urlrequiredstringAudio to clean (mp3, wav, m4a, ogg, aac), or a video whose soundtrack to clean.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • lip_sync_video

    Lip sync videoChanges data
    Parameters (7)
    NameTypeWhat it is
    video_urlrequiredstringThe existing video whose mouths should move.
    audio_urlstringThe voice, which replaces the video's audio. Leave it out when the video already has the voice in it.
    promptstringWho says what, in plain words, for example "the first voice is the owl, the second is the squirrel". Used with model sync-3; leave it out when the speakers are obvious.
    audio_start_secondsnumberSeconds into the video where the voice in audio_url starts, when it is shorter than the video and belongs at a set moment. Only that stretch is lip-synced; the video's sound plays around and under the voice.
    modelstringpixverse (default) or sync-3. Leave it out unless the user names a model.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • list_budget_projects

    List Budget ProjectsRead-only
    Parameters (2)
    NameTypeWhat it is
    budget_projectstringOptional: one project's slug, id, or name, to list its latest generations.
    include_archivedbooleanInclude archived projects in the list.
  • list_characters

    List CharactersRead-only
    Parameters (0)

    No parameters.

  • list_film_projects

    List Film ProjectsRead-only
    Parameters (0)

    No parameters.

  • list_review_requests

    List review requestsRead-only
    Parameters (0)

    No parameters.

  • list_speech_pronunciations

    List speech pronunciationsRead-only
    Parameters (4)
    NameTypeWhat it is
    family"elevenlabs" | "fish" | "google" | "minimax" | "chatterbox" | "kokoro" | "orpheus"Model family, shared across versions and voices: elevenlabs covers v2 and v4, google covers both Gemini TTS models, fish covers Fish Drama 3.
    languagestringLanguage code, for example he or en. Regional codes share their base-language rules.
    limitintegerEntries to return.
    offsetintegerEntries to skip: the nextOffset of the previous page.
  • list_templates

    List TemplatesRead-only
    Parameters (2)
    NameTypeWhat it is
    include_htmlbooleanAlso return each full template. Default: false.
    name_containsstringCase-insensitive filter on name and description.
  • list_themes

    List themesRead-only
    Parameters (0)

    No parameters.

  • merge_media

    Merge MediaChanges data
    Parameters (12)
    NameTypeWhat it is
    video_urlsstring[]2 to 25 videos in playback order. Pass this or audio_urls.
    video_fit"auto" | "crop" | "pad" | "strict"How clips of a different shape fit the canvas. Default: auto.
    canvas_video_indexintegerZero-based index of the video that sets the canvas. Default: 0.
    pad_color"black" | "white" | "gray"Bar color for video_fit=pad. Default: black.
    target_fpsnumberOutput frame rate, 1 to 60. Default: the lowest input frame rate.
    audio_urlsstring[]Audio files in order. Only the first 5 are joined per job.
    audio_format"mp3" | "m4a" | "wav"Audio output. Default: wav for WAV-only inputs, m4a for AAC-only inputs, otherwise mp3.
    crossfade_secondsnumberAudio: overlap each adjacent pair, 0 to 30 seconds.
    normalize_loudnessbooleanAudio: match each input's loudness before joining.
    target_lufsnumberAudio: target loudness, -30 to -5. Default: -18.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • open_studio

    Open StudioRead-only
    Parameters (1)
    NameTypeWhat it is
    page"home" | "explore" | "library" | "characters" | "voices" | "approvals" | "billing" | "settings"Page to open: home, explore (examples to start from), library, characters, voices (saved designed and cloned voices), approvals, billing or settings. Omit for Home.
  • overlay_images

    Overlay ImagesChanges data
    Parameters (4)
    NameTypeWhat it is
    video_urlrequiredstringVideo to put the images on.
    overlaysrequiredobject[]Later entries appear above earlier ones.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • rate_asset

    Rate assetChanges data
    Parameters (4)
    NameTypeWhat it is
    asset_idrequiredstringThe asset being rated.
    rating"up" | "down" | nullThumbs up, thumbs down, or null to clear.
    favoritebooleanKeep it in Favorites.
    notestringOptional feedback note.
  • render_html_image

    Render HTML ImageChanges data
    Parameters (9)
    NameTypeWhat it is
    htmlrequiredstringHTML to render. Write it as for a real browser. Use {{token}} for inline_images.
    widthintegerOutput width in pixels. Default: 1200.
    heightintegerOutput height in pixels. Default: 630.
    inline_imagesobject[]Images or fonts to embed. Every {{token}} needs a matching entry.
    transparent_backgroundbooleanMake unused pixels transparent in the PNG.
    namestringOptional asset name for the saved file.
    tagsstring[]Optional tags for the saved file.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • render_html_video

    Render HTML VideoChanges data
    Parameters (12)
    NameTypeWhat it is
    htmlstringThe composition. Pass this, project_url or project_asset_id.
    project_urlstringPublicly downloadable HTTPS URL of a static project ZIP, e.g. a ZIP URL from search_examples({ id }).
    project_asset_idstringA ZIP in the Library instead of html: a project asset (get_upload_url type project, recommended) or an ordinary zip asset. Static projects only: index.html or a built dist/index.html.
    durationnumberSeconds, up to 300. Default: 5.
    fpsnumber24, 30 or 60; others are rounded to the nearest. Default: 30.
    widthintegerEven number, 2-3840. Default: 1920.
    heightintegerEven number, 2-3840. Default: 1080.
    format"mp4" | "webm" | "mov"Default: mp4.
    namestringOptional asset name for the saved file.
    tagsstring[]Optional tags for the saved file.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • render_template

    Render TemplateChanges data
    Parameters (10)
    NameTypeWhat it is
    template_idstringTemplate ID. Pass this or template_name.
    template_namestringTemplate name, ignoring case. Pass this or template_id.
    rendersrequiredobject[]Variants to render, 1 to 4.
    size_namesstring[]Named sizes to render, or ["all"].
    width_overrideintegerOverride the width of a single-size render.
    height_overrideintegerOverride the height of a single-size render.
    namestringOptional asset name for the saved file.
    tagsstring[]Optional tags for the saved file.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • scale_video

    Scale VideoChanges data
    Parameters (7)
    NameTypeWhat it is
    video_urlrequiredstringVideo to scale.
    widthintegerTarget width, 2-7680, even.
    heightintegerTarget height, 2-4320, even.
    mode"stretch" | "pad" | "crop"stretch distorts to fit, pad letterboxes, crop center-crops. Default: stretch.
    pad_color"black" | "white" | "red" | "green" | "blue" | "gray"Bar color for mode=pad. Default: black.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • search_examples

    Search ExamplesRead-only
    Parameters (8)
    NameTypeWhat it is
    querystringWhat the user wants to make.
    output_type"image" | "video" | "audio"Only this media type.
    model_idstringOnly examples for this model.
    render_type"html_video"html_video finds runnable HyperFrames examples.
    tagsstring[]Every result must have all of these.
    limitintegerResults per page. Default: 30.
    cursorstringFrom a previous page.
    idstringLoad one example in full; other filters are ignored.
  • search_voices

    Search voicesRead-only
    Parameters (7)
    NameTypeWhat it is
    querystringA few words on how the voice should sound or what it is for, such as warm calm narrator or energetic ad. Put language, gender, and accent in their own fields.
    modelstringExact speech model ID, such as speech/elevenlabs-v4, to return only voices that work with it. Omit to search every speech model.
    gender"male" | "female"Voice gender.
    languagestringLanguage the voice will speak: a code or English name, such as es, en-AU, or Spanish. Multilingual voices also match.
    accentstringAccent or region, such as australian, british, or southern.
    limitintegerVoices to return.
    offsetintegerVoices to skip, to get the next page of the same search.
  • set_review_mode

    Set review modeChanges data
    Parameters (1)
    NameTypeWhat it is
    moderequired"review" | "auto"review or auto.
  • show_budget_project

    Show Budget ProjectRead-only
    Parameters (2)
    NameTypeWhat it is
    budget_projectstringProject to open: its slug, or an id or name. Omit to show all projects.
    tab"generations" | "media" | "approvals" | "projects"Tab to open: generations (default, one row per charged generation), media, approvals or projects (all projects).
  • stitch_clips

    Stitch ClipsChanges data
    Parameters (5)
    NameTypeWhat it is
    clipsrequiredobject[]Clips in playback order.
    audioobjectOptional audio to mix over the clips.
    content_fit"contain" | "cover"Default: contain.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • swap_video_characters

    Swap Video CharactersChanges data
    Parameters (7)
    NameTypeWhat it is
    video_urlstringDirect video file URL, at least 4 seconds. Up to 30 seconds is used; longer sources are cut. Import social post links with upload_asset first.
    image_urlsstring[]Reference photos. One photo may contain several replacement people; describe which person in each photo replaces which person in the source video.
    character_idsstring[]Saved Characters to swap in; their images count toward the 8 references.
    instructionsstringDescribe the edit in your own words: who in the video becomes whom, including left/right or clothing descriptions within group photos, who stays unchanged, and any requested face, hair, clothing or other visual changes. Explicit instructions guide the previews and video; extra photos do not require extra replacements.
    resolution"480p" | "720p" | "1080p"480p (default) renders a native draft that can be rendered at 1080p later from the card; 720p or 1080p render that resolution directly.
    video_model"video/seedance-2.5" | "video/wan-3.0" | "video/kling-4.0-omni"video/seedance-2.5 (default, Pro): up to 30 seconds of input video and 8 combined references. video/wan-3.0 and video/kling-4.0-omni are not supported for swaps and return an error.
    reviewbooleanPass true only when the user asks to check the previews before rendering: it keeps the Review step even if the account renders in Auto mode. Omit it otherwise; the account setting applies.
  • transcribe

    TranscribeChanges data
    Parameters (6)
    NameTypeWhat it is
    audio_urlstringA direct audio file, or a video whose soundtrack to transcribe. Pass this or video_url.
    video_urlstringA direct video file, supported social post or public Google Drive link. Social sources try transcript retrieval first, then download and transcribe the audio if necessary. Pass this or audio_url.
    language_codestringISO-639 code (e.g. "en", "es"; "en-GB" is read as "en"). Social sources: captions in another language are skipped for the audio fallback. Speech to text detects the language itself; a transcript plainly in another language comes with a warning.
    max_durationintegerSocial sources: the longest full source in seconds, not a trim range. Default 7200; longer sources are rejected. The complete bounded quote must fit the balance.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • trim_video

    Trim VideoChanges data
    Parameters (8)
    NameTypeWhat it is
    video_urlstringVideo to trim. Pass this or audio_url, not both.
    audio_urlstringAudio to trim, or a video whose soundtrack should be cut. Returns audio only. Pass this or video_url, not both.
    start_timenumberStart in seconds. Default: 1.
    end_timenumberEnd in seconds. Takes precedence over duration.
    durationnumberSeconds from start_time. Default: 2. Ignored if end_time is given.
    audio_format"mp3" | "m4a" | "wav"Audio output format when audio_url is given. Default: mp3.
    force_newbooleanAn identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.
    budget_projectstringOptional budget project this generation's cost counts toward, for tracking spend per client or job. Pass its slug; an id or the exact display name also works. Create one with create_budget_project and find slugs with list_budget_projects. An unknown project never stops the generation: it runs without one, and the result warns how to add it with assign_to_budget_project.
  • update_budget_project

    Update Budget ProjectDeletes
    Parameters (5)
    NameTypeWhat it is
    budget_projectrequiredstringThe budget project's slug, e.g. papercraft-tarot. An id or the exact display name also works.
    namestringNew display name.
    slugstringNew slug.
    notesstring | nullNew notes; null clears them.
    archivedbooleantrue archives the project, false restores it.
  • update_character

    Update CharacterDeletes
    Parameters (11)
    NameTypeWhat it is
    idrequiredstringID of the Character to update.
    titlestringNew name.
    descriptionstringAppearance, personality, role: added to prompts at generation time.
    image_urlstringReference portrait or character sheet URL: the visual anchor for generate_image and generate_video.
    profile_image_urlstringSmall browsing portrait, stored separately from image_url. If omitted when adding or changing a sheet, a profile portrait is generated asynchronously with normal image credits. For a portrait-only Character, pass the portrait URL as both image_url and profile_image_url.
    voice_modelstringSpeech model of an existing public voice, such as speech/elevenlabs-v4.
    voice_idstringExact public voice ID for voice_model, from get_model_params. This does not create a new voice.
    voice_namestringOptional display name for the saved public voice.
    voice_preview_idstringpreview_id of a design_voice audition to save as a voice of this Character. It becomes a private Fish voice that speaks with speech/fish-drama-3.
    voice_languagestring | nullOptional voice preview language code, such as en, he or es. Null clears it. With a saved voice, setting or changing language generates one short localized preview asynchronously using normal speech credits. Omit to keep the current value; no language means no automatic preview.
    replace_voice_option_idstringWith voice_preview_id, replace this saved designed voice option instead of adding another. The old provider voice is deleted. Only on the user's explicit request.
  • update_film_project

    Update Film ProjectDeletes
    Parameters (13)
    NameTypeWhat it is
    idrequiredstringFilm project id from create_film_project or list_film_projects.
    namestringNew project title.
    briefstringNew creative brief.
    loglinestringThe film's one-line premise.
    status"drafting" | "script_ok" | "storyboard_ok" | "rendering" | "preview_ok" | "final"Approval stage; moves forward one stage per call.
    character_idsstring[]Character ids for the cast.
    theme_idstringBrand theme id.
    target_duration_snumberTarget total film length in seconds; fractional values are rounded.
    audio_urlstringFull narration track URL
    assembled_urlstringFinal stitched film URL
    shotsobject[]Full validated shot list; replaces the existing list.
    patch_shotsobject[]Validated partial shot updates merged by stable id.
    budget_projectstring | nullTie this film to a budget project (slug, id or name); null removes it.
  • update_template

    Update TemplateDeletes
    Parameters (13)
    NameTypeWhat it is
    template_idstringTemplate ID. Pass this or template_name.
    template_namestringTemplate name, ignoring case. Pass this or template_id.
    namestringNew name.
    descriptionstringNew description.
    htmlstringhtml kind: replacement markup.
    widthintegerhtml kind: new width.
    heightintegerhtml kind: new height.
    sizesobject[]Pass [] to clear and use width/height.
    parametersobject[]Replacement parameter list.
    promptstringgenerative kind: replacement prompt.
    recommended_modelstringgenerative kind: new model ID.
    model_paramsobjectgenerative kind: replacement model parameters.
    reference_asset_idsstring[]generative kind: replacement reference assets.
  • update_theme

    Update themeDeletes
    Parameters (6)
    NameTypeWhat it is
    namestringTheme name. Creates the theme if it doesn't exist. Required unless interactive is true.
    dataobjectTheme data: colors, fonts, logos, etc. Merged with existing data by default.
    imagesstring[]Brand reference images for this theme. Replaces the entire images array when provided. The first image is saved as the thumbnail.
    overridebooleanIf true, replaces the entire theme data. Default false: top-level keys are replaced and missing keys are preserved. Only applies to data.
    set_defaultbooleanIf true, makes this theme the default.
    interactivebooleanWhen true, open the visual theme editor in the chat instead of saving. The user fills in the form and saves there; name is optional. Use this whenever the user says "edit my theme", "create a theme" or "help me set up a brand".
  • update_video_workflow

    Update Video WorkflowDeletes
    Parameters (8)
    NameTypeWhat it is
    session_idrequiredstringThe session ID from the workflow’s result, for example a swap_video_characters result.
    expected_versionrequiredintegerThe version from the latest result for this session. A stale version is refused so a newer change is never overwritten; check_job with the session ID returns the current one.
    preview_indexintegerWhich preview to change, counting from 0 in the result’s previews list.
    changesstringWhat to change in that preview, in plain words.
    source"previous" | "original"Refine the previous preview, or restart from the original source frame to fix pose, anatomy, crop or background drift. Defaults to previous.
    scope"frame" | "all"Update one frame (default) or redo every preview from the original source frames.
    source_video_job_idstringAccepted for compatibility: sources are fitted automatically, so it is never needed.
    video_model"video/kling-4.0-omni" | "video/wan-3.0"Not supported: only Seedance 2.5 renders swaps, so these values return an error.