Catalogue d’outils

Découvrez les outils de la Direct API et leurs JSON Schemas, et consultez chaque outil de la v1 avec l’autorisation dont il a besoin.

La Direct API est générée à partir des mêmes définitions d’outils que le serveur MCP de Morphic : le catalogue que sert l’API est donc toujours le catalogue en vigueur, y compris chaque modèle que votre forfait peut utiliser.

Découvrir les outils

RequêteRenvoie
GET /v1/direct/toolstous les outils que cette clé peut appeler, avec leurs JSON Schemas complets, sous la forme { "tools": [ … ] }
GET /v1/direct/tools/{tool_name}une entrée de cette liste, sous la forme { "tool": { … } }
GET /v1/direct/openapi.jsonun document OpenAPI 3.1 pour toute l’API, construit à partir des mêmes définitions ; utilisez-le pour générer un client typé
curl -s https://mcp.morphic.com/v1/direct/tools \
  -H "Authorization: Bearer $MORPHIC_API_KEY"
{
  "tools": [
    {
      "name": "generate_image",
      "title": "Generate image",
      "description": "Text to image. TAKES IN: a prompt … PRODUCES: one new image per variation …",
      "required_scopes": ["generations:write"],
      "charges_credits": true,
      "returns_generation": true,
      "input_schema":  { "type": "object", "properties": { "prompt": { "type": "string", "maxLength": 4000 }, "…": {} }, "required": ["prompt"], "additionalProperties": false },
      "output_schema": { "type": "object", "properties": { "generation_id": { "type": "string" }, "…": {} } },
      "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }
    }
  ]
}
ChampSignification
charges_creditsl’outil peut dépenser des crédits ; voir Crédits et consommation
returns_generationl’outil lance un travail asynchrone que vous suivez sous forme de génération
input_schemaJSON Schema de input dans le corps de l’appel. Strict : une clé inconnue est refusée, pas ignorée.
output_schemaJSON Schema de result dans la réponse. Ouvert : de nouveaux champs peuvent apparaître.

Outils de la v1

GET /v1/direct/tools est la liste de référence, toujours à jour. Dans la v1 :

Compte et catalogue (gratuits)

OutilAutorisationRôle
list_voicesaucuneles voix proposées par un modèle de synthèse vocale, chacune avec son voice_id
list_projectsprojects:readvos projets
list_workflows, get_workflowprojects:readles workflows enregistrés
list_charactersassets:readles personnages entraînés, avec l’identifiant que prend une modification
list_elementsassets:readles Éléments de votre organisation (personnages et styles entraînés), avec l’identifiant qu’une génération prend comme référence
plan_mediaassets:readvalider un plan en plusieurs étapes et en obtenir le devis ; voir Obtenir un devis avant de dépenser

Bibliothèque (gratuits)

OutilAutorisationRôle
list_assetsassets:readenvois, générations et documents, avec leurs liens ; un fichier transmis par URL apparaît ici
list_generationsassets:readles générations récentes avec leur statut et leurs assets

Image (payants, renvoient des générations)

Autorisation generations:write : generate_image, edit_image, upscale_image, enhance_image, outpaint_image, inpaint_image, image_compose, image_crop, image_resize, image_rotate, image_flip, image_extend_to_aspect_ratio, image_make_color_transparent.

Vidéo (payants, renvoient des générations)

Autorisation generations:write : generate_video, edit_video, upscale_video, enhance_video, finalize_video_draft, lip_sync, video_compose, video_resize, video_change_frame_rate, video_rotate, video_flip, video_change_speed, video_reverse, video_remove_audio, video_frame_to_image, burn_subtitles, video_to_alpha.

video_to_alpha détoure une personne ou des objets nommés dans une vidéo, sur fond transparent. Il n’est disponible qu’avec les offres Enterprise.

Audio (payants, renvoient des générations)

Autorisation generations:write : generate_speech, generate_music, generate_sound_effect, generate_dialogue, change_voice, transcribe_media, separate_stems, dub_media, audio_compose, audio_trim, extract_audio, ainsi que les effets audio audio_equalize, audio_compress, audio_limit, audio_gate, audio_deess, audio_denoise, audio_reverb, audio_gain et audio_fade, qui renvoient chacun un nouveau fichier audio avec l’effet appliqué.

dub_media prend media_asset_id (un fichier audio ou vidéo), target_language (une étiquette BCP-47 comme hi ou pt-BR ; plusieurs langues font plusieurs appels), un source_language facultatif (détecté s’il est omis), des keyterms facultatifs (noms et termes à garder tels quels, jusqu’à 5 mots chacun) et un model_id facultatif. Sur Morphic Dub (mdl_h2z5a7af7y50), il renvoie la vidéo elle-même, aux lèvres synchronisées, et le montant facturé au lancement est une estimation régularisée d’après la dépense réelle de l’exécution. Morphic Dub prend aussi voice_mode: "assigned" avec voices (chaque locuteur sous forme d’asset image ou audio, ou d’une courte description, avec un voice_id issu de list_voices pour mdl_h2z5a7af7y50 ; voix du catalogue uniquement), et votre propre SRT minuté dans source_transcript_asset_id (langue parlée) ou translation_asset_id (langue cible), par URL ou comme document de votre bibliothèque, avec l’un ou l’autre mode de voix. Via MCP, ElevenLabs Dubbing (model_name: "ElevenLabs Dubbing") prend aussi les deux SRT, avec les voix originales : source_language est obligatoire avec eux, et la traduction ne va qu’avec la transcription. Voir Doublage.

Analyse (payants, répondent pendant l’appel)

analyze_video et analyze_audio nécessitent les autorisations generations:write et assets:read. Ils ne lancent aucune génération, et le montant facturé est remboursé si l’analyse échoue.

Timelines Compose

Les outils de ce groupe conservent le préfixe filmlab_ dans leur nom.

OutilAutorisationFacturation
filmlab_list_timelines, filmlab_read_timelineprojects:readgratuit
filmlab_create_timelineassets:writegratuit
filmlab_get_documentationaucunegratuit
filmlab_editgenerations:write et assets:writepar commande
filmlab_exportgenerations:writerenvoie une génération

Absents de la Direct API

Outil MCPÀ utiliser à la place
list_modelsModèles
get_credit_balanceGET /v1/direct/me
get_generation_status, wait_for_generations, show_generation, show_assetGET /v1/direct/generations/{id} et POST /v1/direct/generations/batch-get

Si vous rencontrez le moindre problème ou si vous avez des questions, n’hésitez pas à nous contacter. Nous serons ravis de vous aider. Écrivez-nous à support@morphic.com.

Sur cette page