Serveur MCP

Tutorializer Video Tutorials

com.tutorializer/tutorializer
Éducation Médias et contenu Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Manages localized tutorials, voiceover segments, pronunciation rules, and registered rendered tutorial videos.

create_project
Create a tutorial project
Use this when someone wants to start a new Tutorializer project for a product or app. Returns the new project's id, name, vanity id, domain and default locale. Each call creates another project. Not for changing an existing project.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Project name as people will see it, up to 120 characters'}, 'domain': {'type': 'string', 'maxLength': 253, 'minLength': 1, 'description': 'Domain of the product the tutorials cover, e.g. example.com; optional'}, 'defaultLocale': {'type': 'string', 'maxLength': 16, 'minLength': 2, 'description': 'Main language code of the tutorials, e.g. en or pt-BR; optional'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'project'], 'properties': {'status': {'type': 'string', 'const': 'created'}, 'project': {'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'defaultLocale'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63, 'minLength': 1}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 16}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}
create_speech
Create a voiceover line
Use this when someone wants new narration or voiceover in a project. Returns the new line's id, language, voice and audio URL. Without url the audio is synthesized from the text with the project's voice provider, spending the organization's synthesis credits; with url it records audio you already have. Not for fixing an existing line.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'text', 'language'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https URL of audio you already produced. Supplying it records the segment without synthesizing anything.'}, 'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'Words to speak, up to 5000 characters'}, 'voice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Optional voice id; defaults to the project's default voice"}, 'language': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'Language code of the narration, e.g. en or pt-BR'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project the voiceover line belongs to'}, 'translatedText': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'Optional translation spoken instead of the source text'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'synthesized', 'speech'], 'properties': {'speech': {'type': 'object', 'required': ['id', 'projectId', 'language', 'voice', 'url', 'duration', 'textPreview', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'voice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'textPreview': {'anyOf': [{'type': 'string', 'maxLength': 5000}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'status': {'enum': ['created', 'recorded'], 'type': 'string'}, 'synthesized': {'type': 'boolean', 'description': 'True when audio was synthesized and synthesis credits were spent; false when a url was recorded'}}, 'additionalProperties': False}
create_tutorial
Create a tutorial
Use this when someone wants to add a new tutorial to a project. Returns the new tutorial's id, name, project and default voice. Each call creates another tutorial; it records the tutorial without recording or rendering a video. Not for adding a rendered video.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial name, up to 200 characters'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project the tutorial belongs to'}, 'defaultVoice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional voice id used when narration is synthesized for this tutorial'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorial'], 'properties': {'status': {'type': 'string', 'const': 'created'}, 'tutorial': {'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}
create_video
Add a rendered tutorial video
Use this when someone has an already uploaded tutorial video file and wants it listed under a tutorial. Returns the new video record with its language, device, dimensions and URLs. Host the file first and pass its public https URL; each call adds another record. Not for recording, rendering or uploading a video.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'tutorialId', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https URL of the already-uploaded video file'}, 'width': {'type': 'integer', 'maximum': 100000, 'description': 'Width in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'device': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Device the video was rendered for: computer, tablet or smartphone'}, 'format': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Container or codec, e.g. mp4 or webm'}, 'height': {'type': 'integer', 'maximum': 100000, 'description': 'Height in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'locale': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'Language code of this video, e.g. en or pt-BR'}, 'duration': {'type': 'number', 'maximum': 86400, 'minimum': 0, 'description': 'Duration in seconds, up to 86400'}, 'fileSize': {'type': 'number', 'maximum': 1000000000000000, 'minimum': 0, 'description': 'File size in bytes'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project that owns the tutorial'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial this video is a rendering of'}, 'chaptersUrl': {'$ref': '#/properties/url', 'description': 'Public https URL of the chapters track'}, 'subtitlesUrl': {'$ref': '#/properties/chaptersUrl', 'description': 'Public https URL of a WebVTT subtitle track'}, 'thumbnailUrl': {'$ref': '#/properties/chaptersUrl', 'description': 'Public https URL of the poster image'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'video'], 'properties': {'video': {'type': 'object', 'required': ['id', 'projectId', 'tutorialId', 'url', 'locale', 'device', 'format', 'width', 'height', 'duration', 'fileSize', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'created'}}, 'additionalProperties': False}
delete_speech
Delete a voiceover line
Use this when someone wants one voiceover line permanently deleted with its audio. Returns the deleted line id; the audio and timing files are erased, so restoring it means synthesizing again, which spends credits. Deleting it again changes nothing. Not for changing its words.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['speechId'], 'properties': {'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Voiceover line to delete'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'speechId'], 'properties': {'status': {'type': 'string', 'const': 'deleted'}, 'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
delete_tutorial
Delete a tutorial
Use this when someone wants a tutorial permanently deleted. Returns the deleted tutorial id; its videos and voiceover lines stay and each needs its own delete. Deleting it again changes nothing. Not for removing one language or device version.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tutorialId'], 'properties': {'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial to delete'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorialId'], 'properties': {'status': {'type': 'string', 'const': 'deleted'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
delete_video
Delete a tutorial video
Use this when someone wants one rendered tutorial video permanently deleted. Returns the deleted video id; the record and its video file in Tutorializer storage are erased, so restoring it means uploading or rendering again. Not for deleting the whole tutorial.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['videoId'], 'properties': {'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Video to delete'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'videoId'], 'properties': {'status': {'type': 'string', 'const': 'deleted'}, 'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
get_project
Get project settings
Use this when someone asks about one project's languages, default voice, narration speed or pronunciation rules. Returns its name, domain, default and configured locales, voice settings and up to 50 pronunciation rules, looked up by project id or vanity id. Not for finding languages or devices that lack videos.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'project'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'project': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'defaultLocale', 'locales', 'defaultVoice', 'stability', 'similarityBoost', 'style', 'speed', 'creationTime', 'lastEditTime', 'pronunciationRules', 'pronunciationRuleCount', 'pronunciationRuleCountIsLowerBound', 'pronunciationRulesTruncated'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'speed': {'anyOf': [{'type': 'number', 'maximum': 10, 'minimum': 0.1}, {'type': 'null'}]}, 'style': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63}, {'type': 'null'}]}, 'stability': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'similarityBoost': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'pronunciationRules': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'phonemes', 'alphabet'], 'properties': {'word': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}]}, 'alphabet': {'enum': ['ipa', 'cmu'], 'type': 'string'}, 'phonemes': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 50}, 'pronunciationRuleCount': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'pronunciationRulesTruncated': {'type': 'boolean'}, 'pronunciationRuleCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Project settings; null when not found. Organization ids and pronunciation-dictionary ids are never returned.'}}, 'additionalProperties': False}
get_project_localization_summary
Check missing languages and devices
Use this when someone asks which languages or devices a project still lacks tutorial videos or voiceovers for, or how complete its translations are. Returns video and voiceover counts per language and video counts per device, plus the missing ones, from the latest 100 of each. Not for one tutorial's videos.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}, 'expectedDevices': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': 'Devices each language should have videos for, 1 to 10 names such as computer, tablet or smartphone; defaults to those three'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'summary'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'summary': {'anyOf': [{'type': 'object', 'required': ['project', 'totals', 'localeCoverage', 'localeCoverageTotal', 'localeCoverageTruncated', 'deviceCoverage', 'missingVideoLocales', 'missingSpeechLocales', 'missingDevices', 'coverageDerivedFromTruncatedData'], 'properties': {'totals': {'type': 'object', 'required': ['tutorials', 'videos', 'speeches'], 'properties': {'videos': {'$ref': '#/properties/summary/anyOf/0/properties/totals/properties/tutorials'}, 'speeches': {'$ref': '#/properties/summary/anyOf/0/properties/totals/properties/tutorials'}, 'tutorials': {'type': 'object', 'required': ['count', 'isLowerBound'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'isLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'project': {'type': 'object', 'required': ['id', 'name', 'defaultLocale', 'configuredLocales', 'configuredLocalesTruncated'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'configuredLocales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'configuredLocalesTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'deviceCoverage': {'type': 'array', 'items': {'type': 'object', 'required': ['device', 'videos'], 'properties': {'device': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'videos': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 10}, 'localeCoverage': {'type': 'array', 'items': {'type': 'object', 'required': ['locale', 'configured', 'videos', 'speeches'], 'properties': {'locale': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'videos': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'speeches': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'configured': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 50}, 'missingDevices': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 10}, 'localeCoverageTotal': {'type': 'integer', 'maximum': 300, 'minimum': 0}, 'missingVideoLocales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'missingSpeechLocales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'localeCoverageTruncated': {'type': 'boolean'}, 'coverageDerivedFromTruncatedData': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Coverage from at most the 100 most recently edited tutorials, videos and voiceover lines; coverageDerivedFromTruncatedData is true when more exist. Null when the project is not found.'}}, 'additionalProperties': False}
get_speech
Read a voiceover line
Use this when someone needs the full wording or translation of one voiceover line, or its audio link. Returns its source text, translation, language, voice, duration, project and audio URL. Not for changing the words.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['speechId'], 'properties': {'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Voiceover line id'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'speech'], 'properties': {'speech': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'language', 'voice', 'duration', 'url', 'creationTime', 'lastEditTime', 'text', 'textTruncated', 'translatedText', 'translatedTextTruncated'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'text': {'anyOf': [{'type': 'string', 'maxLength': 4000}, {'type': 'null'}]}, 'voice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'textTruncated': {'type': 'boolean'}, 'translatedText': {'anyOf': [{'type': 'string', 'maxLength': 4000}, {'type': 'null'}]}, 'translatedTextTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
get_tutorial
Get a tutorial and its videos
Use this when someone asks about one tutorial and the videos rendered from it. Returns the tutorial's name, project and default voice plus up to 8 of its most recently edited videos with language, device, format, size and media links. Not for every video in a project.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tutorialId'], 'properties': {'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial id'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorial', 'videoCount', 'videoCountIsLowerBound', 'videos'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'videos': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'locale', 'device', 'format', 'width', 'height', 'url', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 8}, 'tutorial': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'videoCount': {'type': 'integer', 'maximum': 8, 'minimum': 0}, 'videoCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
get_video
Get video details
Use this when someone asks about one tutorial video, such as its link, subtitles, chapters or thumbnail. Returns its tutorial, language, device, dimensions and its video, chapters, subtitles and thumbnail URLs. Not for changing those details.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['videoId'], 'properties': {'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Video id'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'video'], 'properties': {'video': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'tutorialId', 'locale', 'device', 'theme', 'format', 'width', 'height', 'fileSize', 'url', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl', 'creationTime', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'theme': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
list_projects
List your tutorial projects
Use this when someone asks which Tutorializer projects they have, or a project's id is needed. Returns each project's id, name, vanity id, domain and created and edited times, sorted by name, 25 per page by default. Not for a project's languages or voice settings.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Projects per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page; absent for the first page'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projects', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'projects': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}}, 'additionalProperties': False}
list_speeches
List voiceover lines
Use this when someone asks which voiceover or narration lines a project has, optionally in one language. Returns each line's id, a short text preview, language, project and audio URL, most recently edited first, 25 per page by default. Not for the full text of one line.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Voiceover lines per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'language': {'type': 'string', 'maxLength': 32, 'description': 'Only lines in this language code, e.g. en, es or de'}, 'projectId': {'type': 'string', 'maxLength': 200, 'description': 'Only voiceover lines in this project'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectIdFilter', 'languageFilter', 'speeches', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'speeches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'textPreview', 'textTruncated', 'language', 'projectId', 'url', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'textPreview': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'textTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Voiceover lines with a text preview of up to 120 characters, not the full text'}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'languageFilter': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}
list_tutorials
List tutorials
Use this when someone asks which tutorials a project has, or when another tool needs a tutorial id. Returns each tutorial's id, name, project, default voice and times, most recently edited first, 25 per page by default. Not for the rendered videos of each language or device.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Tutorials per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'projectId': {'type': 'string', 'maxLength': 200, 'description': 'Only tutorials in this project; every project when absent'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectIdFilter', 'tutorials', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'tutorials': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'projectIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}
list_videos
List tutorial videos
Use this when someone asks which tutorial videos exist, optionally for one project, tutorial, language or device. Returns each video's id, tutorial, language, device, format, dimensions, file size and URL, most recently edited first, 25 per page by default. Not for checking missing languages.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Videos per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'device': {'type': 'string', 'maxLength': 100, 'description': 'Only videos for this device: computer, tablet or smartphone'}, 'locale': {'type': 'string', 'maxLength': 32, 'description': 'Only videos in this language code, e.g. en or pt-BR'}, 'projectId': {'type': 'string', 'maxLength': 200, 'description': 'Only videos in this project'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'description': 'Only videos of this tutorial'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectIdFilter', 'tutorialIdFilter', 'localeFilter', 'deviceFilter', 'videos', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'videos': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'tutorialId', 'projectId', 'url', 'locale', 'device', 'format', 'width', 'height', 'fileSize', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'hasMore': {'type': 'boolean'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'deviceFilter': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'localeFilter': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}
remove_pronunciation_rule
Remove a pronunciation fix
Use this when someone wants to drop a pronunciation rule so a word is spoken the default way again. Returns whether it was removed and the remaining rule count; a missing rule changes nothing, and existing audio is kept as it is. Not for changing a rule's phonemes.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'word'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Exact word or phrase whose pronunciation rule should be removed'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project the rule belongs to'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectId', 'word', 'remainingRuleCount', 'remainingRuleCountIsLowerBound'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'status': {'enum': ['removed', 'unchanged', 'project-not-found'], 'type': 'string'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'remainingRuleCount': {'anyOf': [{'type': 'integer', 'maximum': 500, 'minimum': 0}, {'type': 'null'}]}, 'remainingRuleCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
set_pronunciation_rule
Fix how a word is pronounced
Use this when narration mispronounces a word, name or brand in a project's voiceovers. Returns the rule and the project's rule count after adding or replacing it (IPA or CMU phonemes, up to 500 rules) and syncing the pronunciation dictionary used for later synthesis. Not for re-voicing lines that already have audio.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'word', 'phonemes'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Exact word or phrase to match, up to 120 characters'}, 'alphabet': {'enum': ['ipa', 'cmu'], 'type': 'string', 'description': 'Phonetic alphabet: ipa or cmu; defaults to ipa'}, 'phonemes': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'How to say it, in the chosen phonetic alphabet, up to 500 characters'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project whose narration to fix'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectId', 'rule', 'ruleCount', 'ruleCountIsLowerBound'], 'properties': {'rule': {'type': 'object', 'required': ['word', 'phonemes', 'alphabet'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'alphabet': {'enum': ['ipa', 'cmu'], 'type': 'string'}, 'phonemes': {'type': 'string', 'maxLength': 500, 'minLength': 1}}, 'additionalProperties': False}, 'status': {'enum': ['added', 'replaced', 'unchanged', 'project-not-found'], 'type': 'string'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'ruleCount': {'anyOf': [{'type': 'integer', 'maximum': 500, 'minimum': 0}, {'type': 'null'}]}, 'ruleCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
show_project_overview
Show project overview
Use this when someone wants a quick visual overview of one Tutorializer project. Returns a card with the project's name, domain and logo, how many tutorials, videos and voiceover lines it has (counted up to 100 each) and its 8 most recently edited tutorials. Not for missing languages or devices.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project', 'tutorialCount', 'tutorialCountIsLowerBound', 'videoCount', 'videoCountIsLowerBound', 'speechCount', 'speechCountIsLowerBound', 'tutorials'], 'properties': {'project': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'domain', 'logo'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'logo': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'tutorials': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'defaultVoice', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 8}, 'videoCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'speechCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'tutorialCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'videoCountIsLowerBound': {'type': 'boolean'}, 'speechCountIsLowerBound': {'type': 'boolean'}, 'tutorialCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
update_project
Change project settings
Use this when someone wants to rename a project or change its domain, languages, default voice or narration speed. Returns the updated settings; fields left out keep their values, and a new locales list replaces the whole set. Not for pronunciation fixes.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'New project name, up to 120 characters'}, 'speed': {'type': 'number', 'maximum': 10, 'minimum': 0.1, 'description': 'New narration speed multiplier, from 0.1 to 10'}, 'domain': {'type': 'string', 'maxLength': 253, 'minLength': 1, 'description': 'New product domain, e.g. example.com'}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32, 'minLength': 2}, 'maxItems': 100, 'minItems': 1, 'description': 'Complete list of language codes the project publishes, 1 to 100; it replaces the current list, and languages left out stop being expected'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}, 'defaultVoice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New default voice id for synthesized narration'}, 'defaultLocale': {'type': 'string', 'maxLength': 16, 'minLength': 2, 'description': 'New main language code, e.g. en or pt-BR'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'project'], 'properties': {'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}, 'project': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'defaultLocale', 'locales', 'defaultVoice', 'speed', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'speed': {'anyOf': [{'type': 'number', 'maximum': 10, 'minimum': 0.1}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
update_speech
Change a voiceover line
Use this when someone wants to change the words, translation, language or voice of one voiceover line. Returns the updated line. A real change re-synthesizes its audio with the project's voice provider, spending synthesis credits and replacing the old audio; identical values change nothing. Not for project-wide pronunciation fixes.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['speechId'], 'properties': {'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'New words to speak, up to 5000 characters'}, 'voice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New voice id for this line'}, 'language': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'New language code, e.g. en or pt-BR'}, 'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Voiceover line to edit'}, 'translatedText': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'New translation spoken instead of the source text'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'resynthesized', 'speech'], 'properties': {'speech': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'language', 'voice', 'url', 'duration', 'textPreview', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'voice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'textPreview': {'anyOf': [{'type': 'string', 'maxLength': 5000}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}, 'resynthesized': {'type': 'boolean', 'description': 'True when the change re-synthesized the audio and spent synthesis credits'}}, 'additionalProperties': False}
update_tutorial
Rename a tutorial or change its voice
Use this when someone wants to rename a tutorial or change the default voice of its narration. Returns the updated tutorial; fields left out keep their values, and repeating the same values changes nothing. Not for editing narration text.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tutorialId'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New tutorial name, up to 200 characters'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial to edit'}, 'defaultVoice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New default voice id for synthesized narration'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorial'], 'properties': {'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}, 'tutorial': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
update_video
Fix a video's details
Use this when someone wants to correct a tutorial video's language, device, dimensions, file link, subtitles, chapters or thumbnail. Returns the updated video record; fields left out keep their values and identical values change nothing. Not for re-rendering the video itself.
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['videoId'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'New public https URL of the video file'}, 'width': {'type': 'integer', 'maximum': 100000, 'description': 'New width in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'device': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'New device: computer, tablet or smartphone'}, 'format': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'New container or codec, e.g. mp4 or webm'}, 'height': {'type': 'integer', 'maximum': 100000, 'description': 'New height in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'locale': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'New language code, e.g. en or pt-BR'}, 'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Video to correct'}, 'duration': {'type': 'number', 'maximum': 86400, 'minimum': 0, 'description': 'New duration in seconds, up to 86400'}, 'fileSize': {'type': 'number', 'maximum': 1000000000000000, 'minimum': 0, 'description': 'New file size in bytes'}, 'chaptersUrl': {'$ref': '#/properties/url', 'description': 'New public https URL of the chapters track'}, 'subtitlesUrl': {'$ref': '#/properties/url', 'description': 'New public https URL of a WebVTT subtitle track'}, 'thumbnailUrl': {'$ref': '#/properties/url', 'description': 'New public https URL of the poster image'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'video'], 'properties': {'video': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'tutorialId', 'url', 'locale', 'device', 'format', 'width', 'height', 'duration', 'fileSize', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
Modifié
show_project_overview
29 September 2026 02:50
Modifié
delete_video
29 September 2026 02:50
Modifié
delete_speech
29 September 2026 02:50
Modifié
delete_tutorial
29 September 2026 02:50
Modifié
remove_pronunciation_rule
29 September 2026 02:50
Modifié
set_pronunciation_rule
29 September 2026 02:50
Modifié
update_speech
29 September 2026 02:50
Modifié
create_speech
29 September 2026 02:50
Modifié
update_video
29 September 2026 02:50
Modifié
create_video
29 September 2026 02:50
Modifié
update_tutorial
29 September 2026 02:50
Modifié
create_tutorial
29 September 2026 02:50
Modifié
update_project
29 September 2026 02:50
Modifié
create_project
29 September 2026 02:50
Modifié
get_speech
29 September 2026 02:50
Modifié
list_speeches
29 September 2026 02:50
Modifié
get_video
29 September 2026 02:50
Modifié
list_videos
29 September 2026 02:50
Modifié
get_tutorial
29 September 2026 02:50
Modifié
list_tutorials
29 September 2026 02:50
Modifié
get_project_localization_summary
29 September 2026 02:50
Modifié
get_project
29 September 2026 02:50
Modifié
list_projects
29 September 2026 02:50
Ajouté
show_project_overview
21 September 2026 02:48
Ajouté
delete_video
21 September 2026 02:48
Ajouté
delete_speech
21 September 2026 02:48
Ajouté
delete_tutorial
21 September 2026 02:48
Ajouté
remove_pronunciation_rule
21 September 2026 02:48
Ajouté
set_pronunciation_rule
21 September 2026 02:48
Ajouté
update_speech
21 September 2026 02:48