Serveur MCP

Cannon Studio

app.cannonstudio/cannon-studio

Ce que fait ce MCP

Manages creative worlds, assets, projects, scenes, and generation requests while providing product, pricing, and developer API information.

api_status
Check Cannon Studio Developer API Status
Check authenticated Cannon Studio account/API connectivity before estimating or creating requests. Requires OAuth or a developer API key; may update key/token usage metadata, but does not spend credits, enqueue jobs, change assets, or expose secrets.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'status', 'response'], 'properties': {'ok': {'type': 'boolean'}, 'status': {'type': 'number'}, 'response': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': False}
compare_alternatives
Compare Cannon Studio Alternatives
Compare Cannon Studio's fit against named alternatives for a use case. Public read-only: no auth, no state changes, no charges; it returns approved positioning and cautions agents not to invent competitor claims.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['use_case'], 'properties': {'use_case': {'type': 'string', 'minLength': 1, 'description': 'Specific job-to-be-done for the comparison, such as UGC ads, AI filmmaking, image generation, 3D workflows, team review, or API media generation.'}, 'alternatives': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional competitor/tool names the user mentioned, such as Runway, LTX Studio, Pika, Midjourney, Higgsfield, or a generic point generator.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['use_case', 'alternatives', 'positioning', 'caution', 'sources'], 'properties': {'caution': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'snippet': {'type': 'string'}}, 'additionalProperties': False}}, 'use_case': {'type': 'string'}, 'positioning': {'type': 'string'}, 'alternatives': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
create_creator_flow_project
Create Creator Flow Project
Create a blank Creator Flow project with one scene and shot in an owned world, or a new world when world_id is omitted. This creates draft records only; no generation or credit spend.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['title'], 'properties': {'title': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'summary': {'type': 'string', 'maxLength': 4000}, 'world_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Existing owned world. Omit to create a new world.'}, 'aspect_ratio': {'enum': ['16:9', '9:16', '1:1'], 'type': 'string', 'default': '16:9'}}, 'additionalProperties': False}
create_generation_request
Create Cannon Studio Generation Request
Create billable async Cannon Studio generation work only after explicit user approval. Requires OAuth or a developer API key; can spend credits up to max_credits and cannot be cancelled through MCP after submission. Use estimate_generation_cost first, then set confirmed=true and a user-approved max_credits cap. This tool does not create API keys, charge payment methods directly, or delete assets.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operation', 'input'], 'properties': {'input': {'type': 'object', 'description': 'Operation-specific request payload. Use the exact shape documented by get_api_operation for the selected operation; this is the billable payload that will be submitted if confirmed and within max_credits.', 'additionalProperties': {}}, 'confirmed': {'type': 'boolean', 'description': 'Must be true only after the user explicitly approves this billable generation request, including operation, payload, and max_credits. Missing or false returns a confirmation error and creates no job.'}, 'operation': {'type': 'string', 'minLength': 1, 'description': 'Cannon Studio developer API operation id to run. Use get_api_operation first if unsure. Examples: image.generate, video.generate, three_d.model.generate, three_d.location.generate, music.generate, narration.generate, subtitles.generate.'}, 'max_credits': {'type': 'number', 'minimum': 0, 'description': 'Highest credit spend the user explicitly approved for this request. The tool rejects the request when the current estimate is greater than this cap.'}, 'webhook_url': {'type': 'string', 'format': 'uri', 'description': 'Optional HTTPS URL that Cannon Studio calls when the request reaches a terminal succeeded or failed state. Omit when polling with get_generation_request.'}, 'idempotency_key': {'type': 'string', 'description': 'Optional stable retry key for the same operation and payload. Reuse it when retrying after a network/client error; do not generate a new key for the same intended request.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'status': {'type': 'number'}, 'response': {'type': 'object', 'additionalProperties': {}}, 'maxCredits': {'type': ['number', 'null']}, 'estimatedCredits': {'type': 'number'}}, 'additionalProperties': False}
create_world
Create World
Create an owned world with title, description, genre, visual style, lore, and production cues. No media generation or credit spend.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['title'], 'properties': {'genre': {'type': 'string', 'maxLength': 120}, 'theme': {'$ref': '#/properties/description'}, 'title': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'description': {'type': 'string', 'maxLength': 4000}, 'visualStyle': {'$ref': '#/properties/description'}, 'importantLore': {'type': 'array', 'items': {'type': 'string', 'maxLength': 240}, 'maxItems': 50}, 'videoProductionCues': {'type': 'array', 'items': {'type': 'string', 'maxLength': 240}, 'maxItems': 50}}, 'additionalProperties': False}
create_world_asset
Create World Asset
Create a reusable owned character, location, object, outfit, ability, or camera from descriptive fields and optional existing HTTPS media references. Does not generate or download media and spends no credits.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'kind'], 'properties': {'kind': {'enum': ['character', 'location', 'object', 'outfit', 'ability', 'camera'], 'type': 'string'}, 'name': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'notes': {'$ref': '#/properties/description'}, 'summary': {'$ref': '#/properties/description'}, 'imageUrl': {'type': 'string', 'format': 'uri', 'maxLength': 8192}, 'world_id': {'type': 'string', 'maxLength': 600, 'minLength': 1}, 'description': {'type': 'string', 'maxLength': 4000}, 'referenceImages': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 8192}, 'maxItems': 20}, 'imagePromptAddon': {'$ref': '#/properties/description'}, 'videoPromptAddon': {'$ref': '#/properties/description'}}, 'additionalProperties': False}
delete_creator_flow_project
Delete Creator Flow Project
Preview deletion by default. Only the owner can permanently delete the project and its story/collaboration records. Keep dry_run=true until the user approves the stated impact; then set dry_run=false, confirmed=true, and expected_title from the preview. Preserves world/library assets.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id'], 'properties': {'dry_run': {'type': 'boolean', 'default': True, 'description': 'Preview deletion impact; defaults to true.'}, 'confirmed': {'type': 'boolean', 'default': False, 'description': 'True only when the user explicitly requested this deletion after seeing its impact.'}, 'project_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Project ID returned by list_creator_flow_projects.'}, 'expected_title': {'type': 'string', 'maxLength': 1000, 'minLength': 1, 'description': 'Exact current title from the preview. Required when deleting.'}}, 'additionalProperties': False}
delete_world
Delete World
Preview world deletion including its project count. After explicit approval, supply dry_run=false, confirmed=true, expected_title. Deletes world projects/stories/relationships and detaches reusable assets using the app's deletion service.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['world_id'], 'properties': {'dry_run': {'type': 'boolean', 'default': True, 'description': 'Preview deletion impact; defaults to true.'}, 'world_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'World ID returned by list_worlds.'}, 'confirmed': {'type': 'boolean', 'default': False, 'description': 'True only when the user explicitly requested this deletion after seeing its impact.'}, 'expected_title': {'type': 'string', 'maxLength': 1000, 'minLength': 1, 'description': 'Exact current title from the preview. Required when deleting.'}}, 'additionalProperties': False}
delete_world_asset
Delete World Asset
Preview an owned library asset deletion. Only after explicit approval set dry_run=false, confirmed=true, expected_title. Existing projects may lose references to the deleted asset.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['asset_id', 'kind'], 'properties': {'kind': {'enum': ['character', 'location', 'object', 'outfit', 'ability', 'camera'], 'type': 'string'}, 'dry_run': {'type': 'boolean', 'default': True, 'description': 'Preview deletion impact; defaults to true.'}, 'asset_id': {'type': 'string', 'maxLength': 600, 'minLength': 1}, 'world_id': {'$ref': '#/properties/asset_id'}, 'confirmed': {'type': 'boolean', 'default': False, 'description': 'True only when the user explicitly requested this deletion after seeing its impact.'}, 'expected_title': {'type': 'string', 'maxLength': 1000, 'minLength': 1, 'description': 'Exact current title from the preview. Required when deleting.'}}, 'additionalProperties': False}
estimate_generation_cost
Estimate Developer API Generation Cost
Estimate credits for a Cannon Studio generation request before creating billable work. Requires OAuth or a developer API key; it may update key/token usage metadata but does not spend credits, enqueue jobs, or change assets. Use get_api_operation first if operation or input fields are unclear, then pass the same operation/input pair to create_generation_request after user approval.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operation', 'input'], 'properties': {'input': {'type': 'object', 'description': 'Operation-specific request payload to estimate. Use the exact shape documented by get_api_operation for the selected operation, for example image.generate expects fields like prompt/model/aspect_ratio, video.generate expects prompt/model/duration/aspect_ratio, and three_d.location.generate expects description with optional source_image_urls and angle_context.', 'additionalProperties': {}}, 'operation': {'type': 'string', 'minLength': 1, 'description': 'Cannon Studio developer API operation id to price. Use get_api_operation first if unsure. Examples: image.generate, video.generate, three_d.model.generate, three_d.location.generate, music.generate, narration.generate, subtitles.generate.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'type': 'boolean'}, 'note': {'type': 'string'}, 'error': {'type': 'string'}, 'label': {'type': 'string'}, 'status': {'type': 'number'}, 'response': {'type': 'object', 'additionalProperties': {}}, 'operation': {'type': 'string'}, 'estimatedCredits': {'type': ['number', 'null']}}, 'additionalProperties': False}
export_creator_flow_project
Export Creator Flow Project
Export a standalone HTML project overview or versioned JSON snapshot as an embedded file resource. Save the resource text verbatim to the returned filename and open the file for the user. HTML shows chapters/scenes/shots, images, videos, audio, missing visuals, search, print/PDF, and JSON download. Media is linked, not bundled, and needs network access. Private export: share only as requested.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id'], 'properties': {'format': {'enum': ['html', 'json'], 'type': 'string', 'default': 'html', 'description': 'HTML is a standalone visual overview with a JSON download; JSON is machine-readable project state.'}, 'project_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Project ID returned by list_creator_flow_projects.'}}, 'additionalProperties': False}
fetch
Fetch Cannon Studio Knowledge Record
Fetch one public Cannon Studio knowledge record by id after search. Public read-only: no auth, no state changes, no charges; use search first when you do not already have a record id.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Record id returned by the search tool.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'title', 'text', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': False}
get_api_operation
Get Cannon Studio API Operation Docs
Return public docs for Cannon Studio developer API operations and payload shapes. Public read-only: no auth, no state changes, no charges; use this before estimate_generation_cost or create_generation_request when operation/input fields are unclear.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'operation': {'type': 'string', 'description': 'Optional operation id such as image.generate, video.generate, three_d.model.generate, three_d.location.generate, narration.generate, or subtitles.generate.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operations'], 'properties': {'operations': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url', 'summary', 'text'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'summary': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_checkout_link
Get Cannon Studio Checkout Link
Return the first-party Cannon Studio checkout or inquiry URL for a selected offering. Public read-only: no auth, no state changes, no charges; use list_offerings first to get a valid product_key.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_key'], 'properties': {'product_key': {'type': 'string', 'minLength': 1, 'description': 'Offering id returned by list_offerings, such as subscription:creator:month or credits:2500.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['productKey', 'offering', 'checkoutUrl', 'chargeStatus', 'createsStripeSession', 'nextStep', 'safety'], 'properties': {'safety': {'type': 'string'}, 'nextStep': {'type': 'string'}, 'offering': {'type': 'object', 'required': ['id', 'kind', 'label', 'summary', 'priceUsd', 'interval', 'credits', 'checkoutUrl', 'requiresLogin', 'tags', 'notes'], 'properties': {'id': {'type': 'string'}, 'kind': {'type': 'string'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}, 'label': {'type': 'string'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'credits': {'type': ['number', 'null']}, 'summary': {'type': 'string'}, 'interval': {'type': ['string', 'null']}, 'priceUsd': {'type': ['number', 'null']}, 'checkoutUrl': {'type': 'string'}, 'requiresLogin': {'type': 'boolean'}}, 'additionalProperties': False}, 'productKey': {'type': 'string'}, 'checkoutUrl': {'type': 'string'}, 'chargeStatus': {'type': 'string'}, 'createsStripeSession': {'type': 'boolean'}}, 'additionalProperties': False}
get_creator_flow_project
Get Creator Flow Project
Inspect an accessible project's saved chapters, scenes, shots, visual readiness, linked media, and scoped assets. Returns a versioned snapshot. Use export_creator_flow_project when the user wants a visual overview or file.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id'], 'properties': {'project_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Project ID returned by list_creator_flow_projects.'}}, 'additionalProperties': False}
get_generation_request
Poll and Sync Cannon Studio Generation Request
Poll and sync an existing Cannon Studio generation request by id. Requires OAuth or a developer API key; not a pure read because it may update lastPolledAt, sync downstream task state, update logs, and deliver one pending terminal webhook. It does not create work, spend credits, cancel jobs, delete data, or change assets. Poll sparingly using poll_after_ms or 10-30 second intervals.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1, 'description': 'Cannon Studio request id returned by create_generation_request or POST /api/v1/requests. This is not a provider task id.'}, 'include_logs': {'type': 'boolean', 'description': 'Set true only when the user explicitly asks to inspect retained request logs for this request.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'status': {'type': 'number'}, 'response': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': False}
get_model_availability
Get Cannon Studio Model Availability
List public Cannon Studio model availability by product surface. Public read-only: no auth, no state changes, no charges; model availability is surface-specific and does not guarantee account eligibility or remaining credits.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'surface': {'type': 'string', 'description': 'Optional surface filter, such as image tools, video tools, Creator Flow, World Generator, image-api, video-api, or three-d-api.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['surfaces', 'note'], 'properties': {'note': {'type': 'string'}, 'surfaces': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}}, 'additionalProperties': False}
get_pricing_context
Get Cannon Studio Pricing Context
Explain public Cannon Studio pricing, credits, plans, and usage tradeoffs. Public read-only: no auth, no state changes, no charges; use list_offerings or get_checkout_link only when the user asks for available purchase paths.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'plan': {'type': 'string', 'description': 'Optional plan or tier name the user mentioned, such as free, hobbyist, creator, pro, team, or enterprise.'}, 'use_case': {'type': 'string', 'description': 'Optional workload or scenario to price, such as UGC ads, AI video, 3D generation, narration, team workflows, or developer API automation.'}, 'media_type': {'type': 'string', 'description': 'Optional media category, such as image, video, 3D, audio, narration, subtitles, lip sync, or post-production.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['summary', 'use_case', 'media_type', 'plan', 'sources'], 'properties': {'plan': {'type': ['string', 'null']}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'snippet': {'type': 'string'}}, 'additionalProperties': False}}, 'summary': {'type': 'string'}, 'use_case': {'type': ['string', 'null']}, 'media_type': {'type': ['string', 'null']}}, 'additionalProperties': False}
get_world
Get World
Read an owned world's summary and media. Use list_world_assets to inspect its library and list_creator_flow_projects for project discovery.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['world_id'], 'properties': {'world_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'World ID returned by list_worlds.'}}, 'additionalProperties': False}
get_world_asset
Get World Asset
Read one owned library asset's descriptive state and media. Use the kind and world_id from discovery; locations may be world-scoped.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['asset_id', 'kind'], 'properties': {'kind': {'enum': ['character', 'location', 'object', 'outfit', 'ability', 'camera'], 'type': 'string'}, 'asset_id': {'type': 'string', 'maxLength': 600, 'minLength': 1}, 'world_id': {'$ref': '#/properties/asset_id'}}, 'additionalProperties': False}
list_capabilities
List Cannon Studio Capabilities
List public Cannon Studio capabilities for an audience, workflow, or output type. Public read-only: no auth, no state changes, no charges; use search or fetch when the user needs deeper source text.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'audience': {'type': 'string', 'description': 'Optional persona or buyer filter, such as creators, agencies, marketing teams, filmmakers, developers, or teams.'}, 'workflow': {'type': 'string', 'description': 'Optional workflow filter, such as UGC ads, Creator Flow, World Generator, API automation, 3D generation, audio, or post-production.'}, 'output_type': {'type': 'string', 'description': 'Optional desired output format, such as image, video, 3D model, 3D location, narration, music, subtitles, or lip sync.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['summary', 'stats', 'matches'], 'properties': {'stats': {'type': 'object', 'additionalProperties': {}}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'snippet': {'type': 'string'}, 'category': {'type': 'string'}}, 'additionalProperties': False}}, 'summary': {'type': 'string'}}, 'additionalProperties': False}
list_creator_flow_projects
List Creator Flow Projects
Discover your owned and shared Creator Flow projects with IDs, roles, direct links, and final videos. May backfill legacy collaboration indexes. Start here when the user mentions their project.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 30, 'maximum': 100, 'minimum': 1, 'description': 'Maximum returned records.'}, 'cursor': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Last returned ID, for the next page.'}}, 'additionalProperties': False}
list_offerings
List Cannon Studio Offerings
List public Cannon Studio plans, credit packs, and team offerings. Public read-only: no auth, no state changes, no charges; returns first-party checkout or inquiry URLs without creating Stripe sessions or granting credits.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'type': 'string', 'description': 'Optional offering kind filter: free, subscription, credit_pack, or team.'}, 'interval': {'type': 'string', 'description': 'Optional subscription interval filter: month or year.'}, 'include_checkout_links': {'type': 'boolean', 'description': 'Set false to omit checkout URLs from the response.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['offerings', 'notes'], 'properties': {'notes': {'type': 'array', 'items': {'type': 'string'}}, 'offerings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'label', 'summary', 'priceUsd', 'interval', 'credits', 'checkoutUrl', 'requiresLogin', 'tags', 'notes'], 'properties': {'id': {'type': 'string'}, 'kind': {'type': 'string'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}, 'label': {'type': 'string'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'credits': {'type': ['number', 'null']}, 'summary': {'type': 'string'}, 'interval': {'type': ['string', 'null']}, 'priceUsd': {'type': ['number', 'null']}, 'checkoutUrl': {'type': 'string'}, 'requiresLogin': {'type': 'boolean'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_toolkits
List Cannon Studio Toolkits
List first-party Cannon Studio image, video, audio, subtitle, editing, Composer, and 3D toolkit surfaces, including which ones are developer-API operations and which should be opened in the app or routed through Director Mode. Public read-only: no auth, no state changes, no charges.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'action': {'type': 'string', 'description': 'Optional action filter such as generate, edit, upscale, trim, stitch, lip_sync, transcribe, or delivery.'}, 'family': {'type': 'string', 'description': 'Optional toolkit family filter such as image, video, audio, subtitles, editing, motion, composer, script, or 3d.'}, 'media_type': {'type': 'string', 'description': 'Optional media filter such as image, video, audio, subtitles, model3d, script, or timeline.'}, 'project_context_only': {'type': 'boolean', 'description': 'Set true to return only toolkit surfaces that can operate from selected project or Director Mode asset context.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['toolkits', 'note'], 'properties': {'note': {'type': 'string'}, 'toolkits': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}}, 'additionalProperties': False}
list_world_assets
List World Assets
Discover asset kinds, then page through owned characters, locations, objects, outfits, abilities, or cameras. Select kind; optionally filter world_id. Returns asset IDs, descriptions, media links, and next_cursor.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'enum': ['character', 'location', 'object', 'outfit', 'ability', 'camera'], 'type': 'string'}, 'limit': {'type': 'integer', 'default': 30, 'maximum': 100, 'minimum': 1, 'description': 'Maximum returned records.'}, 'cursor': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Last returned ID, for the next page.'}, 'world_id': {'$ref': '#/properties/cursor'}}, 'additionalProperties': False}
list_worlds
List Worlds
Page through your owned worlds with titles, descriptions, media, and direct links. Returns a next_cursor when more worlds exist.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 30, 'maximum': 100, 'minimum': 1, 'description': 'Maximum returned records.'}, 'cursor': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Last returned ID, for the next page.'}}, 'additionalProperties': False}
recommend_workflow
Recommend Cannon Studio Workflow
Recommend a Cannon Studio workflow for a stated creative or developer goal. Public read-only: no auth, no state changes, no charges; use this for planning, not to create generation jobs.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['goal'], 'properties': {'goal': {'type': 'string', 'minLength': 1, 'description': "User's desired outcome or problem to solve, such as producing UGC ads, planning a short film, generating 3D assets, or automating API media generation."}, 'audience': {'type': 'string', 'description': 'Optional user or organization type, such as solo creator, agency, brand team, developer, filmmaker, or enterprise team.'}, 'team_size': {'type': 'string', 'description': 'Optional team context, such as solo, small team, agency team, or enterprise team; used to bias collaboration and review recommendations.'}, 'output_type': {'type': 'string', 'description': 'Optional final output target, such as image, video, ad, trailer, 3D model, 3D location, audio, subtitles, or API integration.'}, 'budget_sensitivity': {'type': 'string', 'description': 'Optional cost posture, such as low, medium, high, cost-sensitive, or speed-prioritized; used to frame pricing and iteration tradeoffs.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['goal', 'recommendation', 'steps', 'sources'], 'properties': {'goal': {'type': 'string'}, 'steps': {'type': 'array', 'items': {'type': 'string'}}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'snippet': {'type': 'string'}}, 'additionalProperties': False}}, 'recommendation': {'type': 'string'}}, 'additionalProperties': False}
search
Search Cannon Studio Knowledge
Search public Cannon Studio knowledge when a user asks about products, workflows, pricing, models, comparisons, use cases, or developer API docs. Public read-only: no auth, no state changes, no charges; call fetch with a returned id when full source-backed text is needed.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Maximum number of results. Defaults to 8 and caps at 20.'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Natural-language query to search Cannon Studio public knowledge.'}, 'audience': {'type': 'string', 'description': 'Optional audience/persona filter such as creators, agencies, marketing teams, or developers.'}, 'category': {'type': 'string', 'description': 'Optional category filter such as pricing, developer, comparison, model_availability, use_case, tools, or creator_flow.'}, 'pain_point': {'type': 'string', 'description': 'Optional pain point filter such as consistent characters, cost predictability, team review, model choice, or finishing.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'snippet': {'type': 'string'}, 'category': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
update_creator_flow_project
Update Creator Flow Project
Edit an accessible project's title, summary, or visual style. Requires editor access and respects another collaborator's active edit lease. Does not regenerate media.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id'], 'properties': {'title': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'summary': {'type': 'string', 'maxLength': 4000}, 'project_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'Project ID returned by list_creator_flow_projects.'}, 'visualStyle': {'$ref': '#/properties/summary'}}, 'additionalProperties': False}
update_world
Update World
Update an owned world's descriptive fields. Omitted fields remain unchanged; empty strings/arrays clear optional fields. Does not rewrite existing media.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['world_id'], 'properties': {'genre': {'type': 'string', 'maxLength': 120}, 'theme': {'$ref': '#/properties/description'}, 'title': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'world_id': {'type': 'string', 'maxLength': 600, 'minLength': 1, 'description': 'World ID returned by list_worlds.'}, 'description': {'type': 'string', 'maxLength': 4000}, 'visualStyle': {'$ref': '#/properties/description'}, 'importantLore': {'type': 'array', 'items': {'type': 'string', 'maxLength': 240}, 'maxItems': 50}, 'videoProductionCues': {'type': 'array', 'items': {'type': 'string', 'maxLength': 240}, 'maxItems': 50}}, 'additionalProperties': False}
update_world_asset
Update World Asset
Edit an owned reusable asset's descriptive fields and existing media references using the app's asset service. Does not generate new media.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['asset_id', 'kind'], 'properties': {'kind': {'enum': ['character', 'location', 'object', 'outfit', 'ability', 'camera'], 'type': 'string'}, 'name': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'notes': {'$ref': '#/properties/description'}, 'summary': {'$ref': '#/properties/description'}, 'asset_id': {'type': 'string', 'maxLength': 600, 'minLength': 1}, 'imageUrl': {'type': 'string', 'format': 'uri', 'maxLength': 8192}, 'world_id': {'$ref': '#/properties/asset_id'}, 'description': {'type': 'string', 'maxLength': 4000}, 'referenceImages': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 8192}, 'maxItems': 20}, 'imagePromptAddon': {'$ref': '#/properties/description'}, 'videoPromptAddon': {'$ref': '#/properties/description'}}, 'additionalProperties': False}
Ajouté
delete_world_asset
17 September 2026 07:57
Ajouté
update_world_asset
17 September 2026 07:57
Ajouté
create_world_asset
17 September 2026 07:57
Ajouté
get_world_asset
17 September 2026 07:57
Ajouté
list_world_assets
17 September 2026 07:57
Ajouté
delete_world
17 September 2026 07:57
Ajouté
update_world
17 September 2026 07:57
Ajouté
create_world
17 September 2026 07:57
Ajouté
get_world
17 September 2026 07:57
Ajouté
list_worlds
17 September 2026 07:57
Ajouté
export_creator_flow_project
17 September 2026 07:57
Ajouté
delete_creator_flow_project
17 September 2026 07:57
Ajouté
update_creator_flow_project
17 September 2026 07:57
Ajouté
create_creator_flow_project
17 September 2026 07:57
Ajouté
get_creator_flow_project
17 September 2026 07:57
Ajouté
list_creator_flow_projects
17 September 2026 07:57
Ajouté
get_generation_request
17 September 2026 07:57
Ajouté
create_generation_request
17 September 2026 07:57
Ajouté
estimate_generation_cost
17 September 2026 07:57
Ajouté
api_status
17 September 2026 07:57
Ajouté
get_api_operation
17 September 2026 07:57
Ajouté
list_toolkits
17 September 2026 07:57
Ajouté
get_model_availability
17 September 2026 07:57
Ajouté
get_checkout_link
17 September 2026 07:57
Ajouté
list_offerings
17 September 2026 07:57
Ajouté
get_pricing_context
17 September 2026 07:57
Ajouté
compare_alternatives
17 September 2026 07:57
Ajouté
recommend_workflow
17 September 2026 07:57
Ajouté
list_capabilities
17 September 2026 07:57
Ajouté
fetch
17 September 2026 07:57