{"openapi":"3.1.0","info":{"title":"Makemancer MCP server","version":"0.1.0","description":"Generate and edit images, video, voiceovers, music and sound effects from Claude, ChatGPT and Codex. Pay per generation with credits. Calls are JSON-RPC 2.0 over Streamable HTTP (Model Context Protocol). Use tools/list to read the tools and tools/call with one of the argument schemas below."},"servers":[{"url":"https://makemancer.com"}],"externalDocs":{"url":"https://makemancer.com/developers"},"paths":{"/api/mcp":{"post":{"summary":"Claude, Claude Code, Codex and other MCP apps","security":[{"oauth2":["mcp"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC response (or an SSE stream of them)","content":{"application/json":{"schema":{"type":"object"}},"text/event-stream":{"schema":{"type":"string"}}}},"401":{"description":"Missing or expired OAuth access token"}}}},"/api/mcp/chatgpt":{"post":{"summary":"ChatGPT apps (no purchase tools)","security":[{"oauth2":["mcp"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC response (or an SSE stream of them)","content":{"application/json":{"schema":{"type":"object"}},"text/event-stream":{"schema":{"type":"string"}}}},"401":{"description":"Missing or expired OAuth access token"}}}}},"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Authorization code with PKCE. Metadata: https://makemancer.com/.well-known/oauth-authorization-server","flows":{"authorizationCode":{"authorizationUrl":"https://makemancer.com/api/auth/oauth2/authorize","tokenUrl":"https://makemancer.com/api/auth/oauth2/token","scopes":{"mcp":"Use the tools on your account","offline_access":"Stay signed in (refresh tokens)"}}}}},"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","method","id"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","integer"]},"method":{"enum":["initialize","tools/list","tools/call"]},"params":{"type":"object","properties":{"name":{"enum":["generate_image","generate_video","generate_speech","generate_music","generate_sound_effect","remove_background","upscale_image","upscale_video","estimate_generation","list_models","get_model_params","check_job","show_media","search_assets","update_asset","delete_asset","upload_asset","get_upload_url","confirm_upload","load_image","import_chatgpt_media","manage_account","get_credits_balance","get_credits_link","submit_feedback","add_audio_to_video","add_speech_pronunciations","add_subtitles","approve_generation","assemble_film","assign_to_budget_project","clone_voice","create_budget_project","create_character","create_film_project","create_template","cut_and_reframe_video","delete_character","delete_film_project","delete_speech_pronunciations","design_voice","extract_frames","generate_html_video","get_film_project","get_theme","import_media","increase_frame_rate","isolate_audio","lip_sync_video","list_budget_projects","list_characters","list_film_projects","list_review_requests","list_speech_pronunciations","list_templates","list_themes","merge_media","open_studio","overlay_images","rate_asset","render_html_image","render_html_video","render_template","scale_video","search_examples","search_voices","set_review_mode","show_budget_project","stitch_clips","swap_video_characters","transcribe","trim_video","update_budget_project","update_character","update_film_project","update_template","update_theme","update_video_workflow"]},"arguments":{"type":"object"}}}}},"generate_image_arguments":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"description":"What to generate, or the edit instructions when image_url is given."},"model":{"description":"Image model ID. Default image/nano-banana-2.","type":"string","maxLength":200},"image_url":{"description":"Source image to edit (https URL).","type":"string"},"image_urls":{"description":"Reference images (https URLs).","type":"array","items":{"type":"string"}},"character_ids":{"description":"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.","maxItems":16,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"aspect_ratio":{"description":"Output shape such as 16:9; allowed values per model in get_model_params.","type":"string"},"size":{"description":"Legacy alias of aspect_ratio.","type":"string","enum":["1:1","4:5","5:4","9:16","16:9"]},"num_images":{"description":"Number 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.","type":"integer","minimum":1,"maximum":4},"agentic_prompting":{"description":"Optional 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.","type":"boolean"},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["prompt"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"generate_video_arguments":{"type":"object","properties":{"prompt":{"type":"string","description":"Subject, action, camera, setting, timing and sound of the clip."},"model":{"description":"Video model ID. Default video/gemini-omni-flash.","type":"string","maxLength":200},"image_url":{"description":"Literal first frame (https URL).","type":"string"},"last_frame_url":{"description":"Last frame, for models that support it.","type":"string"},"image_urls":{"description":"Reference images that guide but do not become frames.","type":"array","items":{"type":"string"}},"character_id":{"description":"A 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.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"video_urls":{"description":"Reference or source videos.","type":"array","items":{"type":"string"}},"audio_urls":{"description":"Reference audio, for models that support it.","type":"array","items":{"type":"string"}},"duration":{"description":"Length in seconds, e.g. 5 or \"5s\"; limits per model.","anyOf":[{"type":"number"},{"type":"string"}]},"aspect_ratio":{"description":"e.g. 16:9, 9:16, 1:1.","type":"string"},"resolution":{"description":"e.g. 480p, 720p, 1080p; allowed values per model.","type":"string"},"agentic_prompting":{"description":"Optional 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.","type":"boolean"},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["prompt"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"generate_speech_arguments":{"type":"object","properties":{"text":{"description":"Text to speak. Some models take dialogue turns in extras instead.","type":"string"},"model":{"description":"Speech model ID. Default speech/elevenlabs-v4.","type":"string","maxLength":200},"voice_id":{"description":"Stock voice ID from get_model_params or search_voices. For a cloned or designed voice pass character_id instead.","type":"string"},"character_id":{"description":"Character 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.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"voice_option_id":{"description":"A saved voice on that Character. Omit to use the preferred voice for the selected model.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"apply_saved_pronunciations":{"description":"Apply 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.","type":"boolean"},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"generate_music_arguments":{"type":"object","properties":{"prompt":{"description":"Genre, mood, instruments, tempo, structure and vocal role.","type":"string"},"model":{"description":"Music model ID. Default music/standard.","type":"string","maxLength":200},"lyrics":{"description":"Custom lyrics; section tags such as [verse] on their own lines.","type":"string"},"style":{"description":"Style tags for custom mode.","type":"string"},"title":{"description":"Track title for custom mode.","type":"string"},"instrumental":{"description":"No vocals. Default false.","type":"boolean"},"force_instrumental":{"description":"Alias of instrumental.","type":"boolean"},"music_length_ms":{"description":"Approximate length in milliseconds (converted to duration in seconds).","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"audio_url":{"description":"Uploaded source song for music/standard-cover.","type":"string"},"audio_id":{"description":"A generated track to extend, cover or edit: audio_id from the tracks of a completed music result.","type":"string"},"task_id":{"description":"task_id from the same tracks entry (the job_id of that result).","type":"string"},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"generate_sound_effect_arguments":{"type":"object","properties":{"prompt":{"description":"The sound: source, action, space, texture and ending.","type":"string"},"model":{"description":"Sound-effect model ID. Default sfx/elevenlabs-sound-v2.","type":"string","maxLength":200},"duration_seconds":{"description":"Length in seconds; omit to let the model choose.","type":"number"},"loop":{"description":"Make a seamless loop.","type":"boolean"},"prompt_influence":{"description":"How closely to follow the prompt, 0 to 1.","type":"number","minimum":0,"maximum":1},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"remove_background_arguments":{"type":"object","properties":{"media_url":{"type":"string","description":"Image or video to process (https URL)."},"type":{"type":"string","enum":["image","video"],"description":"Kind of media at media_url."},"model":{"description":"Background-removal model ID.","type":"string","maxLength":200},"output_format":{"description":"Video only.","type":"string","enum":["webm","mp4","prores"]},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["media_url","type"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"upscale_image_arguments":{"type":"object","properties":{"image_url":{"type":"string","description":"Image to upscale (https URL)."},"model":{"description":"Image upscaler model ID.","type":"string","maxLength":200},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["image_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"upscale_video_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Video to upscale (https URL)."},"model":{"description":"Video upscaler model ID.","type":"string","maxLength":200},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"estimate_generation_arguments":{"type":"object","properties":{"operation":{"description":"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.","type":"string","enum":["image","video","speech","audio","upscale","video_upscale","html_video","frame_interpolation","lip_sync","swap_video_characters","3d_model","video_edit","media_import","transcribe"]},"model":{"description":"Model ID. Omit to use the default model of the operation.","type":"string","maxLength":200},"params":{"default":{},"description":"The arguments the generation tool would receive (top-level fields and extras).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"list_models_arguments":{"type":"object","properties":{"category":{"description":"Filter by category. Omit to list all.","type":"string","enum":["image","video","speech","audio","music","sfx","upscale","background_removal","frame_interpolation"]},"query":{"description":"Free-text filter on ID, name, description and capabilities.","type":"string","maxLength":200},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"get_model_params_arguments":{"type":"object","properties":{"model":{"type":"string","minLength":1,"maxLength":200,"description":"Model ID, e.g. image/nano-banana-2 or video/seedance-2.5."},"include_voice_catalog":{"description":"Accepted for compatibility; voice IDs are part of the schema.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["model"],"$schema":"http://json-schema.org/draft-07/schema#"},"check_job_arguments":{"type":"object","properties":{"job_id":{"type":"string","minLength":1,"maxLength":400,"description":"job_id returned by a generation tool (or its first eight characters), a cloud_project_id or a swap session_id."},"ui_refresh":{"description":"Accepted for compatibility.","type":"boolean"},"words_offset":{"description":"transcribe: next page of words; pass nextWordsOffset.","type":"integer","minimum":0,"maximum":9007199254740991},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["job_id"],"$schema":"http://json-schema.org/draft-07/schema#"},"show_media_arguments":{"type":"object","properties":{"items":{"minItems":1,"maxItems":24,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","maxLength":100},"job_id":{"type":"string","maxLength":400},"url":{"type":"string","maxLength":2048}},"additionalProperties":false},"description":"Media to show; each item has one of asset_id, job_id or url."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["items"],"$schema":"http://json-schema.org/draft-07/schema#"},"search_assets_arguments":{"type":"object","properties":{"type":{"description":"Asset type.","type":"string","enum":["image","video","audio","document","zip","project","3d_model","font"]},"query":{"description":"Matches the asset name (substring), one tag, or the prompt of the generation that made it (substring).","type":"string","maxLength":200},"tags":{"description":"Assets with any of these tags.","maxItems":20,"type":"array","items":{"type":"string"}},"name":{"description":"Exact asset name.","type":"string","maxLength":200},"source":{"description":"How the asset entered the library.","type":"string","enum":["generated","uploaded","imported"]},"created_from":{"description":"Created at or after this time (ISO 8601).","type":"string"},"created_to":{"description":"Created before this time (ISO 8601).","type":"string"},"limit":{"default":20,"description":"Results per page.","type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"description":"Results to skip.","type":"integer","minimum":0,"maximum":9007199254740991},"favorites_only":{"description":"Not supported; only false is accepted.","type":"boolean"},"budget_project":{"description":"Only 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.","type":"string","minLength":1,"maxLength":200},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"update_asset_arguments":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100,"description":"Asset ID."},"name":{"description":"New name; null clears it.","anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"clear_name":{"description":"Remove the name.","type":"boolean"},"tags":{"description":"Replaces all tags.","maxItems":20,"type":"array","items":{"type":"string"}},"description":{"description":"Accepted for compatibility; not stored.","type":"string"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"delete_asset_arguments":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100,"description":"Asset ID."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"upload_asset_arguments":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public direct file URL or supported social post URL to import and store permanently. Social imports return a job ID for check_job."},"name":{"description":"Asset name; defaults to the file name.","type":"string","maxLength":200},"tags":{"description":"Tags for organizing the asset.","maxItems":20,"type":"array","items":{"type":"string"}},"type":{"description":"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.","type":"string","enum":["image","video","audio","3d_model","zip"]},"quality":{"description":"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.","type":"string","enum":["480p","720p","1080p"]},"max_duration":{"description":"For social links, reject longer sources before downloading. Default 7200 seconds. This rejects long sources; it does not trim them.","type":"integer","minimum":1,"maximum":7200},"content_type":{"description":"Accepted for compatibility; the type is read from the file. Omit for social links.","type":"string"},"description":{"description":"Accepted for compatibility; not stored.","type":"string"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["url"],"$schema":"http://json-schema.org/draft-07/schema#"},"get_upload_url_arguments":{"type":"object","properties":{"content_type":{"type":"string","minLength":1,"maxLength":100,"description":"MIME type, e.g. image/png, video/mp4, audio/mpeg, font/woff2, application/zip. With a generic type (application/octet-stream) the filename extension decides."},"type":{"type":"string","enum":["image","video","audio","3d_model","font","zip","project"],"description":"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."},"bytes":{"description":"Exact file size in bytes, when known; it is then part of the signed upload. confirm_upload checks the size limit either way.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"description":"Asset name.","type":"string","maxLength":200},"filename":{"description":"Original 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.","type":"string","maxLength":300},"tags":{"description":"Tags for organizing the asset.","maxItems":20,"type":"array","items":{"type":"string"}},"description":{"description":"Accepted for compatibility; not stored.","type":"string"},"purpose":{"description":"Use voice_clone for a private voice recording; returns an asset ID for clone_voice, never a public audio URL.","type":"string","enum":["media","voice_clone"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["content_type","type"],"$schema":"http://json-schema.org/draft-07/schema#"},"confirm_upload_arguments":{"type":"object","properties":{"asset_id":{"type":"string","minLength":1,"maxLength":100,"description":"asset_id returned by get_upload_url."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["asset_id"],"$schema":"http://json-schema.org/draft-07/schema#"},"load_image_arguments":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public image URL."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["url"],"$schema":"http://json-schema.org/draft-07/schema#"},"import_chatgpt_media_arguments":{"type":"object","properties":{"media_file":{"type":"object","properties":{"download_url":{"type":"string","description":"Temporary download URL supplied by ChatGPT."},"file_id":{"type":"string","description":"ChatGPT file ID."},"mime_type":{"description":"MIME type, if known.","type":"string"},"file_name":{"description":"Original file name, if known.","type":"string"}},"required":["download_url","file_id"],"additionalProperties":false,"description":"The ChatGPT file to import."},"name":{"description":"Asset name; defaults to the file name.","type":"string","maxLength":200},"tags":{"description":"Tags for organizing the asset.","maxItems":20,"type":"array","items":{"type":"string"}},"type":{"description":"Expected type; the import fails if the file is another type.","type":"string","enum":["image","video","audio"]},"purpose":{"description":"voice_clone keeps an audio recording private for clone_voice and returns its asset ID, never a public URL.","type":"string","enum":["media","voice_clone"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["media_file"],"$schema":"http://json-schema.org/draft-07/schema#"},"manage_account_arguments":{"type":"object","properties":{"section":{"default":"overview","description":"Account section to show: overview, activity or settings.","type":"string","enum":["overview","activity","settings"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"get_credits_balance_arguments":{"type":"object","properties":{"estimate_type":{"description":"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.","type":"string","enum":["image","video","speech","audio","upscale","video_upscale","html_video","frame_interpolation","lip_sync","swap_video_characters","3d_model","video_edit","media_import","transcribe"]},"estimate_model":{"description":"Model ID to estimate.","type":"string","maxLength":200},"estimate_params":{"description":"Arguments of the generation to estimate.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"get_credits_link_arguments":{"type":"object","properties":{"product":{"description":"Pack to highlight; omit to let the user choose.","type":"string","enum":["1000","5000","11000","27500","62500","credits_1000","credits_5250","credits_11000","credits_28750"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"submit_feedback_arguments":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4000,"description":"What worked, broke, was missing or was confusing."},"category":{"type":"string","enum":["bug","generation_quality","missing_feature","confusing","praise","other"],"description":"Kind of feedback."},"source":{"type":"string","enum":["agent","user"],"description":"agent: observed by the assistant; user: the user's own words."},"attemptedTask":{"description":"What the user was trying to do.","type":"string","maxLength":1000},"toolName":{"description":"Tool involved, if any.","type":"string","maxLength":100},"relatedIds":{"description":"Related job or asset IDs.","maxItems":20,"type":"array","items":{"type":"string","maxLength":100}},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["message","category","source"],"$schema":"http://json-schema.org/draft-07/schema#"},"add_audio_to_video_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Video to put the audio on."},"audio_url":{"type":"string","description":"Audio to add, such as narration or music."},"start_offset":{"description":"Seconds after the video starts when the audio begins. Default: 0.","type":"number","minimum":0},"audio_mode":{"description":"Default: replace.","type":"string","enum":["replace","mix"]},"original_volume":{"description":"With mix: gain of the video's own audio, 0 to 1. Default: 1.","type":"number"},"added_volume":{"description":"With mix: gain of audio_url, 0 to 1. Default: 1.","type":"number"},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url","audio_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"add_speech_pronunciations_arguments":{"type":"object","properties":{"entries":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"family":{"type":"string","enum":["elevenlabs","fish","google","minimax","chatterbox","kokoro","orpheus"],"description":"Model family, shared across versions and voices: elevenlabs covers v2 and v4, google covers both Gemini TTS models, fish covers Fish Drama 3."},"language":{"type":"string","pattern":"^[a-zA-Z]{2,3}(?:[-_][a-zA-Z0-9]{2,8})*$","description":"Language code, for example he or en. Regional codes share their base-language rules."},"term":{"type":"string","minLength":1,"maxLength":256},"replacement":{"type":"string","minLength":1,"maxLength":1024,"description":"Exact replacement text, including any supported pronunciation syntax: IPA, niqqud, an alternative spelling or model-specific markup. See get_model_params and the voiceover skill for the selected model."},"variants":{"description":"Explicit alternative spellings of this same term. Whole words/phrases only; no fuzzy matching. A Hebrew term saved without niqqud already matches any niqqud; add a pointed form only as its own term, for a homograph.","maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["family","language","term","replacement"]},"description":"Up to 100 pronunciations to save."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["entries"],"$schema":"http://json-schema.org/draft-07/schema#"},"add_subtitles_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Video to caption."},"language":{"description":"ISO-639 code, sent only when known. Speech language is detected automatically; this picks the font for Chinese, Japanese or Korean.","type":"string"},"font_name":{"description":"Exact 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.","type":"string","maxLength":100},"font_size":{"description":"Preferred size in pixels; kept within a safe range for the frame.","type":"integer","minimum":20,"maximum":150},"font_weight":{"description":"Default: bold. A font without the weight uses its nearest one.","type":"string","enum":["normal","bold","black"]},"font_color":{"description":"Default: white.","type":"string","enum":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"]},"highlight_color":{"description":"Color of the word being spoken, the karaoke cue. Default: white.","type":"string","enum":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"]},"stroke_color":{"description":"Default: black.","type":"string","enum":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"]},"stroke_width":{"description":"Outline in pixels, 0 for none. Default: 3.","type":"integer","minimum":0,"maximum":10},"background_color":{"description":"Box behind the text. Default: none.","type":"string","enum":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta","none","transparent"]},"background_opacity":{"description":"Default: 0.7.","type":"number","minimum":0,"maximum":1},"position":{"description":"Default: bottom.","type":"string","enum":["top","center","bottom"]},"y_offset":{"description":"Top and bottom: inward margin, 20 to 200. Center: pixels below the middle, -200 to 200.","type":"integer","minimum":-200,"maximum":200},"words_per_subtitle":{"description":"Preferred most words per caption; limited by the frame shape.","type":"integer","exclusiveMinimum":0,"maximum":12},"enable_animation":{"description":"Bounce each caption in. Default: false.","type":"boolean"},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"approve_generation_arguments":{"type":"object","properties":{"request_id":{"type":"string","minLength":1,"maxLength":100,"description":"Review request ID."},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"The version shown to the user."},"prompt":{"description":"The prompt as edited in the card.","type":"string","maxLength":20000},"settings":{"description":"Resolution, duration, aspect ratio and audio as chosen.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["request_id","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#"},"assemble_film_arguments":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Existing film project id returned by create_film_project or list_film_projects; never use a placeholder."},"mode":{"default":"connect","description":"connect preserves every clip and warns about target overage; cut_end trims the fully assembled output at the target duration.","type":"string","enum":["connect","cut_end"]},"video_fit":{"default":"crop","description":"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.","type":"string","enum":["auto","crop","pad","strict"]},"with_narration":{"default":true,"description":"Replace 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.","type":"boolean"},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"assign_to_budget_project_arguments":{"type":"object","properties":{"budget_project":{"anyOf":[{"type":"string","minLength":1,"maxLength":200,"description":"The budget project's slug, e.g. papercraft-tarot. An id or the exact display name also works."},{"type":"null"}],"description":"Target project's slug, id, or name; null removes the generations from their project."},"job_ids":{"description":"Generation job ids to move.","maxItems":200,"type":"array","items":{"type":"string","maxLength":100}},"asset_ids":{"description":"Asset ids; each moves its generation.","maxItems":200,"type":"array","items":{"type":"string","maxLength":100}},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["budget_project"],"$schema":"http://json-schema.org/draft-07/schema#"},"clone_voice_arguments":{"type":"object","properties":{"audio_asset_id":{"description":"Private voice recording ID from an upload with purpose voice_clone. Public media assets cannot be used.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audio_url":{"description":"A 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.","type":"string","format":"uri"},"character_id":{"description":"Existing Character to receive the cloned voice. Omit to create a reusable voice-only Character automatically.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"character_name":{"description":"Name for an automatically created voice-only Character. Used only when character_id is omitted; defaults to \"My Voice\".","type":"string","minLength":1,"maxLength":120},"consent":{"description":"Pass 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.","type":"boolean"},"language":{"default":"en","description":"Source recording language code, such as en, es, or he.","type":"string","minLength":2,"maxLength":16},"provider":{"default":"fish","description":"Voice provider. Here only fish is connected and it is the default; providers are never switched silently, so cartesia or elevenlabs is refused.","type":"string","enum":["elevenlabs","cartesia","fish"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"create_budget_project_arguments":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"description":"Display name, e.g. Papercraft Tarot. Unique in the workspace."},"slug":{"description":"Optional kebab-case slug. Generated from the name when omitted.","type":"string","maxLength":64},"notes":{"description":"Optional notes, such as the client or a purchase order.","type":"string","maxLength":1000},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"create_character_arguments":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120,"description":"Character name."},"description":{"description":"Appearance, personality, role: added to prompts at generation time.","type":"string","maxLength":4000},"image_url":{"description":"Reference portrait or character sheet URL: the visual anchor for generate_image and generate_video.","type":"string","format":"uri"},"profile_image_url":{"description":"Small 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.","type":"string","format":"uri"},"voice_model":{"description":"Speech model of an existing public voice, such as speech/elevenlabs-v4.","type":"string","maxLength":200},"voice_id":{"description":"Exact public voice ID for voice_model, from get_model_params. This does not create a new voice.","type":"string","maxLength":200},"voice_name":{"description":"Optional display name for the saved public voice.","type":"string","maxLength":120},"voice_preview_id":{"description":"preview_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.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"voice_language":{"description":"Optional 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.","anyOf":[{"type":"string","minLength":2,"maxLength":20},{"type":"null"}]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["title"],"$schema":"http://json-schema.org/draft-07/schema#"},"create_film_project_arguments":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Short project title"},"brief":{"description":"The user's creative brief / what the film is about","type":"string","maxLength":20000},"character_ids":{"description":"Character ids for the cast (from list_characters)","maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"theme_id":{"description":"Brand theme id","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_duration_s":{"description":"Target total film length in seconds, up to 60 minutes; shot duration is model-dependent. Fractional values are rounded to the nearest second.","type":"number","minimum":4,"maximum":3600},"budget_project":{"type":"string","minLength":1,"maxLength":200,"description":"Tie this film to a budget project (slug, id or name). Its shot clips and assembly count toward it."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"create_template_arguments":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Template name."},"description":{"description":"What this template is for.","type":"string","maxLength":2000},"kind":{"description":"Default: html.","type":"string","enum":["html","generative"]},"parameters":{"description":"The {{token}} inputs: name, type, optional default, description and required.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]*$"},"type":{"type":"string","enum":["text","image_url","color","number","boolean"]},"default":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}},"required":["name","type"]}},"html":{"description":"html kind: markup with {{token}} placeholders.","type":"string"},"width":{"description":"html kind: default width. Required unless sizes is given.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"description":"html kind: default height. Required unless sizes is given.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"sizes":{"description":"html kind: named output sizes; one may set isDefault.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"label":{"type":"string"},"bodyClass":{"type":"string","pattern":"^[\\w\\s-]+$"},"isDefault":{"type":"boolean"}},"required":["name","width","height"]}},"media_type":{"description":"generative kind: output type.","type":"string","enum":["image","video"]},"recommended_model":{"description":"generative kind: model ID.","type":"string"},"prompt":{"description":"generative kind: prompt with {{token}} placeholders.","type":"string"},"model_params":{"description":"generative kind: default model parameters.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"reference_asset_ids":{"description":"generative kind: Library assets passed as references.","type":"array","items":{"type":"string"}},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"cut_and_reframe_video_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"A video in your Library; import the file first."},"segments":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","properties":{"start":{"type":"number","minimum":0,"maximum":14400},"end":{"type":"number","minimum":0,"maximum":14400},"framing":{"description":"Default: pad.","type":"object","properties":{"mode":{"type":"string","enum":["pad","center_crop","crop"]},"width":{"description":"Crop width in source pixels; crop only.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"description":"Crop height in source pixels; crop only.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"x":{"description":"Static crop x in source pixels; crop only.","type":"number"},"y":{"description":"Static crop y in source pixels; crop only.","type":"number"},"keyframes":{"description":"Moving crop; crop only. Do not combine with x and y.","maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"}},"required":["time","x","y"],"additionalProperties":{}}}},"required":["mode"],"additionalProperties":{}}},"required":["start","end"],"additionalProperties":{}},"description":"Half-open source ranges in seconds, in playback order."},"width":{"description":"Output width, even, 128-1920. Default: 1080.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"description":"Output height, even, 128-1920. Default: 1920.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fps":{"description":"Default: source.","type":"string","enum":["24","25","30","50","60","source"]},"audio_fade_ms":{"description":"Fade at each discontinuous audio cut, milliseconds. Default: 30. Above 100 is treated as 100.","type":"number"},"normalize_audio":{"description":"Level the whole output. Default: false.","type":"boolean"},"captions":{"description":"Optional burned captions.","type":"object","properties":{"words":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"}},"required":["start","end","text"],"additionalProperties":{}},"description":"Source-timed words, not output timestamps."},"style":{"description":"Default: plain.","type":"string","enum":["plain","karaoke"]},"words_per_caption":{"description":"Target words per caption. Default: 3. Above 7 is treated as 7.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"font":{"description":"Default: Noto Sans. Text it cannot draw uses the Noto Sans family for that script.","type":"string","enum":["Noto Sans","Noto Sans Hebrew","Noto Sans Arabic","Noto Sans CJK SC","Noto Sans CJK JP","Noto Sans CJK KR"]}},"required":["words"],"additionalProperties":{}},"name":{"description":"Name for the result in the Library.","type":"string","maxLength":200},"tags":{"description":"Tags for the result.","maxItems":30,"type":"array","items":{"type":"string","maxLength":100}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url","segments"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"delete_character_arguments":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"ID of the Character to delete."},"confirm":{"type":"boolean","const":true,"description":"Set true only after the user asked to delete this Character. Deletion cannot be undone."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id","confirm"],"$schema":"http://json-schema.org/draft-07/schema#"},"delete_film_project_arguments":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Film project ID to permanently delete."},"confirm":{"default":false,"description":"True only after the user explicitly confirms deletion of this film.","type":"boolean"},"delete_media":{"default":false,"description":"Also delete currently linked owned media, only if explicitly requested. Defaults to keeping media.","type":"boolean"},"expected_updated_at":{"description":"The project's updatedAt from the preview. Rejects a stale deletion confirmation.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"delete_speech_pronunciations_arguments":{"type":"object","properties":{"ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"description":"Entry IDs from list_speech_pronunciations."},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["ids"],"$schema":"http://json-schema.org/draft-07/schema#"},"design_voice_arguments":{"type":"object","properties":{"prompt":{"type":"string","minLength":20,"maxLength":2000,"description":"Voice description, 20 to 2,000 characters: age, accent, timbre, pacing, tone and speaking style."},"text":{"description":"Audition script spoken by all three candidates: 1 to 150 characters for Fish. Omit when no script exists yet.","type":"string","minLength":1,"maxLength":1000},"provider":{"default":"fish","description":"Voice Design provider. Only fish is connected here and it is the default; elevenlabs and google are refused rather than switched silently.","type":"string","enum":["elevenlabs","google","fish"]},"extras":{"description":"Fish 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.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"language_code":{"description":"BCP-47 audition language, such as en-GB or he-IL (same as extras.language_code).","type":"string"},"guidance_scale":{"description":"Same as extras.guidance_scale.","type":"number"},"instruct_guidance_scale":{"description":"Same as extras.instruct_guidance_scale.","type":"number"},"speed":{"description":"Same as extras.speed.","type":"number"},"num_step":{"description":"Same as extras.num_step.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"seed":{"description":"Same as extras.seed.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"character_id":{"description":"Existing Character the voice is meant for. It is remembered as the place to save; this call saves nothing.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"character_name":{"description":"Name of a new Character the voice is meant for, when character_id is omitted. It labels the options and is remembered for saving.","type":"string","minLength":1,"maxLength":120},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["prompt"],"$schema":"http://json-schema.org/draft-07/schema#"},"extract_frames_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Video file or finished HLS playlist (.m3u8) to extract frames from."},"mode":{"description":"timeline (default), timestamps, single, batch, first, middle or last.","type":"string"},"timestamps":{"description":"Exact positions in seconds. Selects timestamps mode.","maxItems":24,"type":"array","items":{"type":"number"}},"position":{"description":"For single mode: first, middle or last. Default: middle.","type":"string"},"frame_interval":{"description":"Batch only: take every Nth frame (1-300, not seconds). Default: 12.","type":"number"},"max_frames":{"description":"Timeline 1-24 (default 12); batch 1-500 (default 100).","type":"number"},"output_format":{"description":"Batch or timestamps: png (default), jpg or webp.","type":"string"},"quality":{"description":"Batch or timestamps with jpg or webp: 1-100. Default: 95.","type":"number"},"start_time":{"description":"Timeline only: start of the section.","type":"number"},"end_time":{"description":"Timeline only: end of the section.","type":"number"},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"generate_html_video_arguments":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":20000,"description":"The 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_id":{"description":"Project ID from an earlier result. Pass it to change that video; omit it to start a new one.","type":"string"},"duration":{"description":"Seconds, up to 300. Default: 5, or the project's.","type":"number","exclusiveMinimum":0,"maximum":300},"width":{"description":"Even number, 2-3840. Default: 1920, or the project's.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"description":"Even number, 2-3840. Default: 1080, or the project's.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fps":{"description":"24, 30 or 60. Default: 30, or the project's.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"format":{"description":"Default: mp4, or the project's.","type":"string","enum":["mp4","webm","mov"]},"effort":{"description":"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.","type":"string","enum":["light","medium","high"]},"media_budget_credits":{"description":"Most credits the agent may spend on generated media this turn (default 200; 0 for none).","type":"integer","minimum":0,"maximum":500},"reference_assets":{"description":"Files the user supplied or selected (logos, images, audio). Images are shown to the agent; every file can be used in the video.","maxItems":20,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Public HTTPS URL."},"description":{"description":"Its role and how to use it.","type":"string","maxLength":1000}},"required":["url"]}},"project_url":{"description":"Publicly downloadable HTTPS URL of a HyperFrames project ZIP to start a new video from, such as a ZIP URL returned by search_examples({ id }).","type":"string"},"project_asset_id":{"description":"Library ZIP or project asset to start a new video from. It is unpacked as the starting project.","type":"string"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["prompt"],"$schema":"http://json-schema.org/draft-07/schema#"},"get_film_project_arguments":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Film project id from create_film_project or list_film_projects."},"ui_refresh":{"description":"Internal film-preview auto-refresh marker.","type":"boolean","const":true},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"get_theme_arguments":{"type":"object","properties":{"name":{"description":"Theme name. If omitted, returns the default theme.","type":"string","minLength":1,"maxLength":120},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"import_media_arguments":{"type":"object","properties":{"purpose":{"description":"voice_clone: one private voice sample; the card returns audio_asset_id for clone_voice instead of a public URL.","type":"string","enum":["media","voice_clone"]},"context":{"description":"What the files are for; shown on the card.","type":"string","maxLength":200},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"increase_frame_rate_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Finished video to retime."},"model":{"description":"Frame interpolation model ID. Default: frame-interpolation/topaz-apollo.","type":"string","maxLength":200},"extras":{"description":"Model-specific parameters as listed by get_model_params. They are merged with the top-level fields.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"isolate_audio_arguments":{"type":"object","properties":{"audio_url":{"type":"string","description":"Audio to clean (mp3, wav, m4a, ogg, aac), or a video whose soundtrack to clean."},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["audio_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"lip_sync_video_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"The existing video whose mouths should move."},"audio_url":{"description":"The voice, which replaces the video's audio. Leave it out when the video already has the voice in it.","type":"string"},"prompt":{"description":"Who 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.","type":"string","maxLength":2000},"audio_start_seconds":{"description":"Seconds 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.","type":"number","minimum":0},"model":{"description":"pixverse (default) or sync-3. Leave it out unless the user names a model.","type":"string","maxLength":100},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"list_budget_projects_arguments":{"type":"object","properties":{"budget_project":{"description":"Optional: one project's slug, id, or name, to list its latest generations.","type":"string","minLength":1,"maxLength":200},"include_archived":{"default":false,"description":"Include archived projects in the list.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"list_characters_arguments":{"type":"object","properties":{"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"list_film_projects_arguments":{"type":"object","properties":{"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"list_review_requests_arguments":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"},"list_speech_pronunciations_arguments":{"type":"object","properties":{"family":{"type":"string","enum":["elevenlabs","fish","google","minimax","chatterbox","kokoro","orpheus"],"description":"Model family, shared across versions and voices: elevenlabs covers v2 and v4, google covers both Gemini TTS models, fish covers Fish Drama 3."},"language":{"type":"string","pattern":"^[a-zA-Z]{2,3}(?:[-_][a-zA-Z0-9]{2,8})*$","description":"Language code, for example he or en. Regional codes share their base-language rules."},"limit":{"default":100,"description":"Entries to return.","type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"description":"Entries to skip: the nextOffset of the previous page.","type":"integer","minimum":0,"maximum":9007199254740991},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"list_templates_arguments":{"type":"object","properties":{"include_html":{"description":"Also return each full template. Default: false.","type":"boolean"},"name_contains":{"description":"Case-insensitive filter on name and description.","type":"string"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"list_themes_arguments":{"type":"object","properties":{"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"merge_media_arguments":{"type":"object","properties":{"video_urls":{"description":"2 to 25 videos in playback order. Pass this or audio_urls.","maxItems":25,"type":"array","items":{"type":"string"}},"video_fit":{"description":"How clips of a different shape fit the canvas. Default: auto.","type":"string","enum":["auto","crop","pad","strict"]},"canvas_video_index":{"description":"Zero-based index of the video that sets the canvas. Default: 0.","type":"integer","minimum":0,"maximum":9007199254740991},"pad_color":{"description":"Bar color for video_fit=pad. Default: black.","type":"string","enum":["black","white","gray"]},"target_fps":{"description":"Output frame rate, 1 to 60. Default: the lowest input frame rate.","type":"number"},"audio_urls":{"description":"Audio files in order. Only the first 5 are joined per job.","type":"array","items":{"type":"string"}},"audio_format":{"description":"Audio output. Default: wav for WAV-only inputs, m4a for AAC-only inputs, otherwise mp3.","type":"string","enum":["mp3","m4a","wav"]},"crossfade_seconds":{"description":"Audio: overlap each adjacent pair, 0 to 30 seconds.","type":"number"},"normalize_loudness":{"description":"Audio: match each input's loudness before joining.","type":"boolean"},"target_lufs":{"description":"Audio: target loudness, -30 to -5. Default: -18.","type":"number"},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"open_studio_arguments":{"type":"object","properties":{"page":{"description":"Page to open: home, explore (examples to start from), library, characters, voices (saved designed and cloned voices), approvals, billing or settings. Omit for Home.","type":"string","enum":["home","explore","library","characters","voices","approvals","billing","settings"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"overlay_images_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Video to put the images on."},"overlays":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"image_url":{"type":"string","description":"A still image; use a transparent PNG for a logo."},"position":{"type":"string","enum":["top_left","top_center","top_right","center_left","center","center_right","bottom_left","bottom_center","bottom_right"],"description":"One of nine positions on the frame."},"width_percent":{"type":"number","description":"Image width as a percentage of video width, 1 to 100."},"margin_px":{"description":"Inset from the frame edges in pixels. Default: 48.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fit":{"description":"contain shrinks an image that would not fit; strict refuses it. Default: contain.","type":"string","enum":["contain","strict"]}},"required":["image_url","position","width_percent"],"additionalProperties":{}},"description":"Later entries appear above earlier ones."},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url","overlays"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"rate_asset_arguments":{"type":"object","properties":{"asset_id":{"type":"string","minLength":1,"maxLength":100,"description":"The asset being rated."},"rating":{"description":"Thumbs up, thumbs down, or null to clear.","anyOf":[{"type":"string","enum":["up","down"]},{"type":"null"}]},"favorite":{"description":"Keep it in Favorites.","type":"boolean"},"note":{"description":"Optional feedback note.","type":"string","maxLength":1000}},"required":["asset_id"],"$schema":"http://json-schema.org/draft-07/schema#"},"render_html_image_arguments":{"type":"object","properties":{"html":{"type":"string","description":"HTML to render. Write it as for a real browser. Use {{token}} for inline_images."},"width":{"description":"Output width in pixels. Default: 1200.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"description":"Output height in pixels. Default: 630.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"inline_images":{"description":"Images or fonts to embed. Every {{token}} needs a matching entry.","type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"url":{"type":"string"}},"required":["token","url"]}},"transparent_background":{"description":"Make unused pixels transparent in the PNG.","type":"boolean"},"name":{"description":"Optional asset name for the saved file.","type":"string"},"tags":{"description":"Optional tags for the saved file.","type":"array","items":{"type":"string"}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["html"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"render_html_video_arguments":{"type":"object","properties":{"html":{"description":"The composition. Pass this, project_url or project_asset_id.","type":"string","minLength":1},"project_url":{"description":"Publicly downloadable HTTPS URL of a static project ZIP, e.g. a ZIP URL from search_examples({ id }).","type":"string"},"project_asset_id":{"description":"A 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.","type":"string"},"duration":{"description":"Seconds, up to 300. Default: 5.","type":"number","exclusiveMinimum":0},"fps":{"description":"24, 30 or 60; others are rounded to the nearest. Default: 30.","type":"number","exclusiveMinimum":0},"width":{"description":"Even number, 2-3840. Default: 1920.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"description":"Even number, 2-3840. Default: 1080.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"format":{"description":"Default: mp4.","type":"string","enum":["mp4","webm","mov"]},"name":{"description":"Optional asset name for the saved file.","type":"string"},"tags":{"description":"Optional tags for the saved file.","type":"array","items":{"type":"string"}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"render_template_arguments":{"type":"object","properties":{"template_id":{"description":"Template ID. Pass this or template_name.","type":"string"},"template_name":{"description":"Template name, ignoring case. Pass this or template_id.","type":"string"},"renders":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"object","properties":{"modifications":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]}}}},"description":"Variants to render, 1 to 4."},"size_names":{"description":"Named sizes to render, or [\"all\"].","type":"array","items":{"type":"string"}},"width_override":{"description":"Override the width of a single-size render.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height_override":{"description":"Override the height of a single-size render.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"description":"Optional asset name for the saved file.","type":"string"},"tags":{"description":"Optional tags for the saved file.","type":"array","items":{"type":"string"}},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["renders"],"$schema":"http://json-schema.org/draft-07/schema#"},"scale_video_arguments":{"type":"object","properties":{"video_url":{"type":"string","description":"Video to scale."},"width":{"description":"Target width, 2-7680, even.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"description":"Target height, 2-4320, even.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mode":{"description":"stretch distorts to fit, pad letterboxes, crop center-crops. Default: stretch.","type":"string","enum":["stretch","pad","crop"]},"pad_color":{"description":"Bar color for mode=pad. Default: black.","type":"string","enum":["black","white","red","green","blue","gray"]},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["video_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"search_examples_arguments":{"type":"object","properties":{"query":{"description":"What the user wants to make.","type":"string"},"output_type":{"description":"Only this media type.","type":"string","enum":["image","video","audio"]},"model_id":{"description":"Only examples for this model.","type":"string"},"render_type":{"description":"html_video finds runnable HyperFrames examples.","type":"string","enum":["html_video"]},"tags":{"description":"Every result must have all of these.","maxItems":10,"type":"array","items":{"type":"string"}},"limit":{"description":"Results per page. Default: 30.","type":"integer","minimum":1,"maximum":50},"cursor":{"description":"From a previous page.","type":"string"},"id":{"description":"Load one example in full; other filters are ignored.","type":"string","minLength":1},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"search_voices_arguments":{"type":"object","properties":{"query":{"description":"A 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.","type":"string","maxLength":200},"model":{"description":"Exact speech model ID, such as speech/elevenlabs-v4, to return only voices that work with it. Omit to search every speech model.","type":"string","maxLength":80},"gender":{"description":"Voice gender.","type":"string","enum":["male","female"]},"language":{"description":"Language the voice will speak: a code or English name, such as es, en-AU, or Spanish. Multilingual voices also match.","type":"string","maxLength":40},"accent":{"description":"Accent or region, such as australian, british, or southern.","type":"string","maxLength":60},"limit":{"default":8,"description":"Voices to return.","type":"integer","minimum":1,"maximum":20},"offset":{"default":0,"description":"Voices to skip, to get the next page of the same search.","type":"integer","minimum":0,"maximum":1000},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"set_review_mode_arguments":{"type":"object","properties":{"mode":{"type":"string","enum":["review","auto"],"description":"review or auto."}},"required":["mode"],"$schema":"http://json-schema.org/draft-07/schema#"},"show_budget_project_arguments":{"type":"object","properties":{"budget_project":{"description":"Project to open: its slug, or an id or name. Omit to show all projects.","type":"string","minLength":1,"maxLength":200},"tab":{"description":"Tab to open: generations (default, one row per charged generation), media, approvals or projects (all projects).","type":"string","enum":["generations","media","approvals","projects"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"stitch_clips_arguments":{"type":"object","properties":{"clips":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["image","video"]},"url":{"type":"string"},"duration_seconds":{"description":"Required for an image. Omit for a video.","type":"number"},"include_audio":{"description":"For a video, keep its audio. Default: true.","type":"boolean"}},"required":["type","url"],"additionalProperties":{}},"description":"Clips in playback order."},"audio":{"description":"Optional audio to mix over the clips.","type":"object","properties":{"url":{"type":"string"},"start_delay_seconds":{"type":"number"}},"required":["url"],"additionalProperties":{}},"content_fit":{"description":"Default: contain.","type":"string","enum":["contain","cover"]},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"required":["clips"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"swap_video_characters_arguments":{"type":"object","properties":{"video_url":{"description":"Direct 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.","type":"string"},"image_urls":{"description":"Reference photos. One photo may contain several replacement people; describe which person in each photo replaces which person in the source video.","maxItems":8,"type":"array","items":{"type":"string"}},"character_ids":{"description":"Saved Characters to swap in; their images count toward the 8 references.","maxItems":8,"type":"array","items":{"type":"string"}},"instructions":{"description":"Describe 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.","type":"string","maxLength":6000},"resolution":{"description":"480p (default) renders a native draft that can be rendered at 1080p later from the card; 720p or 1080p render that resolution directly.","type":"string","enum":["480p","720p","1080p"]},"video_model":{"description":"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.","type":"string","enum":["video/seedance-2.5","video/wan-3.0","video/kling-4.0-omni"]},"review":{"description":"Pass 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.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"transcribe_arguments":{"type":"object","properties":{"audio_url":{"description":"A direct audio file, or a video whose soundtrack to transcribe. Pass this or video_url.","type":"string"},"video_url":{"description":"A 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.","type":"string"},"language_code":{"description":"ISO-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.","type":"string"},"max_duration":{"description":"Social 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.","type":"integer","minimum":1,"maximum":7200},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"trim_video_arguments":{"type":"object","properties":{"video_url":{"description":"Video to trim. Pass this or audio_url, not both.","type":"string"},"audio_url":{"description":"Audio to trim, or a video whose soundtrack should be cut. Returns audio only. Pass this or video_url, not both.","type":"string"},"start_time":{"description":"Start in seconds. Default: 1.","type":"number"},"end_time":{"description":"End in seconds. Takes precedence over duration.","type":"number"},"duration":{"description":"Seconds from start_time. Default: 2. Ignored if end_time is given.","type":"number"},"audio_format":{"description":"Audio output format when audio_url is given. Default: mp3.","type":"string","enum":["mp3","m4a","wav"]},"force_new":{"description":"An identical request submitted in the last 10 minutes returns that job without charging again; true generates it again.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}},"budget_project":{"description":"Optional 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.","type":"string","minLength":1,"maxLength":200}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"update_budget_project_arguments":{"type":"object","properties":{"budget_project":{"type":"string","minLength":1,"maxLength":200,"description":"The budget project's slug, e.g. papercraft-tarot. An id or the exact display name also works."},"name":{"description":"New display name.","type":"string","minLength":1,"maxLength":80},"slug":{"description":"New slug.","type":"string","maxLength":64},"notes":{"description":"New notes; null clears them.","anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"archived":{"description":"true archives the project, false restores it.","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["budget_project"],"$schema":"http://json-schema.org/draft-07/schema#"},"update_character_arguments":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"ID of the Character to update."},"title":{"description":"New name.","type":"string","minLength":1,"maxLength":120},"description":{"description":"Appearance, personality, role: added to prompts at generation time.","type":"string","maxLength":4000},"image_url":{"description":"Reference portrait or character sheet URL: the visual anchor for generate_image and generate_video.","type":"string","format":"uri"},"profile_image_url":{"description":"Small 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.","type":"string","format":"uri"},"voice_model":{"description":"Speech model of an existing public voice, such as speech/elevenlabs-v4.","type":"string","maxLength":200},"voice_id":{"description":"Exact public voice ID for voice_model, from get_model_params. This does not create a new voice.","type":"string","maxLength":200},"voice_name":{"description":"Optional display name for the saved public voice.","type":"string","maxLength":120},"voice_preview_id":{"description":"preview_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.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"voice_language":{"description":"Optional 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.","anyOf":[{"type":"string","minLength":2,"maxLength":20},{"type":"null"}]},"replace_voice_option_id":{"description":"With 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.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"update_film_project_arguments":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Film project id from create_film_project or list_film_projects."},"name":{"description":"New project title.","type":"string","minLength":1,"maxLength":200},"brief":{"description":"New creative brief.","type":"string","maxLength":20000},"logline":{"description":"The film's one-line premise.","type":"string","maxLength":2000},"status":{"description":"Approval stage; moves forward one stage per call.","type":"string","enum":["drafting","script_ok","storyboard_ok","rendering","preview_ok","final"]},"character_ids":{"description":"Character ids for the cast.","maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"theme_id":{"description":"Brand theme id.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_duration_s":{"description":"Target total film length in seconds; fractional values are rounded.","type":"number","minimum":4,"maximum":3600},"audio_url":{"description":"Full narration track URL","type":"string","format":"uri"},"assembled_url":{"description":"Final stitched film URL","type":"string","format":"uri"},"shots":{"description":"Full validated shot list; replaces the existing list.","maxItems":240,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100,"description":"Stable shot id, for example \"s1\""},"description":{"type":"string","minLength":1,"maxLength":5000,"description":"What happens in this shot"},"prompt":{"description":"Approved motion prompt for the video model","type":"string","maxLength":20000},"narration":{"description":"Voiceover or dialogue text for this shot","type":"string","maxLength":5000},"storyboardUrl":{"description":"Approved clean storyboard image URL","type":"string","format":"uri"},"clipUrl":{"description":"Approved rendered clip URL","type":"string","format":"uri"},"audioUrl":{"description":"Approved per-shot narration or dialogue URL","type":"string","format":"uri"},"durationS":{"description":"Shot duration supported by its model","type":"number","exclusiveMinimum":0},"model":{"description":"Video model id selected for this shot","type":"string","maxLength":200},"resolution":{"description":"Optional output resolution supported by the shot's model. Defaults to 720p or the closest supported tier. Explicit unsupported tiers are rejected. Use the returned resolution in generate_video.","type":"string","minLength":1,"maxLength":20},"status":{"description":"Progress of this shot.","type":"string","enum":["pending","storyboard","clip","done","error"]}},"required":["id","description"],"additionalProperties":false}},"patch_shots":{"description":"Validated partial shot updates merged by stable id.","maxItems":240,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100,"description":"Id of the shot to change."},"description":{"type":"string","minLength":1,"maxLength":5000,"description":"What happens in this shot"},"prompt":{"description":"Approved motion prompt for the video model","type":"string","maxLength":20000},"narration":{"description":"Voiceover or dialogue text for this shot","type":"string","maxLength":5000},"storyboardUrl":{"description":"Approved clean storyboard image URL","type":"string","format":"uri"},"clipUrl":{"description":"Approved rendered clip URL","type":"string","format":"uri"},"audioUrl":{"description":"Approved per-shot narration or dialogue URL","type":"string","format":"uri"},"durationS":{"description":"Shot duration supported by its model","type":"number","exclusiveMinimum":0},"model":{"description":"Video model id selected for this shot","type":"string","maxLength":200},"resolution":{"description":"Optional output resolution supported by the shot's model. Defaults to 720p or the closest supported tier. Explicit unsupported tiers are rejected. Use the returned resolution in generate_video.","type":"string","minLength":1,"maxLength":20},"status":{"description":"Progress of this shot.","type":"string","enum":["pending","storyboard","clip","done","error"]}},"required":["id"],"additionalProperties":false}},"budget_project":{"description":"Tie this film to a budget project (slug, id or name); null removes it.","anyOf":[{"type":"string","minLength":1,"maxLength":200,"description":"Tie this film to a budget project (slug, id or name). Its shot clips and assembly count toward it."},{"type":"null"}]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["id"],"$schema":"http://json-schema.org/draft-07/schema#"},"update_template_arguments":{"type":"object","properties":{"template_id":{"description":"Template ID. Pass this or template_name.","type":"string"},"template_name":{"description":"Template name, ignoring case. Pass this or template_id.","type":"string"},"name":{"description":"New name.","type":"string","minLength":1,"maxLength":200},"description":{"description":"New description.","type":"string","maxLength":2000},"html":{"description":"html kind: replacement markup.","type":"string"},"width":{"description":"html kind: new width.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"description":"html kind: new height.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"sizes":{"description":"Pass [] to clear and use width/height.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"label":{"type":"string"},"bodyClass":{"type":"string","pattern":"^[\\w\\s-]+$"},"isDefault":{"type":"boolean"}},"required":["name","width","height"]}},"parameters":{"description":"Replacement parameter list.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]*$"},"type":{"type":"string","enum":["text","image_url","color","number","boolean"]},"default":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}},"required":["name","type"]}},"prompt":{"description":"generative kind: replacement prompt.","type":"string"},"recommended_model":{"description":"generative kind: new model ID.","type":"string"},"model_params":{"description":"generative kind: replacement model parameters.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"reference_asset_ids":{"description":"generative kind: replacement reference assets.","type":"array","items":{"type":"string"}},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"update_theme_arguments":{"type":"object","properties":{"name":{"description":"Theme name. Creates the theme if it doesn't exist. Required unless interactive is true.","type":"string","minLength":1,"maxLength":120},"data":{"description":"Theme data: colors, fonts, logos, etc. Merged with existing data by default.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"images":{"description":"Brand reference images for this theme. Replaces the entire images array when provided. The first image is saved as the thumbnail.","maxItems":30,"type":"array","items":{"type":"string","format":"uri"}},"override":{"description":"If true, replaces the entire theme data. Default false: top-level keys are replaced and missing keys are preserved. Only applies to data.","type":"boolean"},"set_default":{"description":"If true, makes this theme the default.","type":"boolean"},"interactive":{"description":"When 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\".","type":"boolean"},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"$schema":"http://json-schema.org/draft-07/schema#"},"update_video_workflow_arguments":{"type":"object","properties":{"session_id":{"type":"string","description":"The session ID from the workflow’s result, for example a swap_video_characters result."},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"The 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_index":{"description":"Which preview to change, counting from 0 in the result’s previews list.","type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"description":"What to change in that preview, in plain words.","type":"string","minLength":1,"maxLength":3000},"source":{"description":"Refine the previous preview, or restart from the original source frame to fix pose, anatomy, crop or background drift. Defaults to previous.","type":"string","enum":["previous","original"]},"scope":{"description":"Update one frame (default) or redo every preview from the original source frames.","type":"string","enum":["frame","all"]},"source_video_job_id":{"description":"Accepted for compatibility: sources are fitted automatically, so it is never needed.","type":"string"},"video_model":{"description":"Not supported: only Seedance 2.5 renders swaps, so these values return an error.","type":"string","enum":["video/kling-4.0-omni","video/wan-3.0"]},"skills_used":{"description":"Optional workflow analytics: names of the skills (or skill/reference paths) followed for this call. Stored with generation jobs only. Never include private data, local paths or media URLs.","maxItems":32,"type":"array","items":{"type":"string","maxLength":300}}},"required":["session_id","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#"}}}}