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ête | Renvoie |
|---|---|
GET /v1/direct/tools | tous 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.json | un 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 }
}
]
}| Champ | Signification |
|---|---|
charges_credits | l’outil peut dépenser des crédits ; voir Crédits et consommation |
returns_generation | l’outil lance un travail asynchrone que vous suivez sous forme de génération |
input_schema | JSON Schema de input dans le corps de l’appel. Strict : une clé inconnue est refusée, pas ignorée. |
output_schema | JSON 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)
| Outil | Autorisation | Rôle |
|---|---|---|
list_voices | aucune | les voix proposées par un modèle de synthèse vocale, chacune avec son voice_id |
list_projects | projects:read | vos projets |
list_workflows, get_workflow | projects:read | les workflows enregistrés |
list_characters | assets:read | les personnages entraînés, avec l’identifiant que prend une modification |
plan_media | assets:read | valider un plan en plusieurs étapes et en obtenir le devis ; voir Obtenir un devis avant de dépenser |
Bibliothèque (gratuits)
| Outil | Autorisation | Rôle |
|---|---|---|
list_assets | assets:read | envois, générations et documents, avec leurs liens ; un fichier transmis par URL apparaît ici |
list_generations | assets:read | les 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.
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.
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.
| Outil | Autorisation | Facturation |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | gratuit |
filmlab_create_timeline | assets:write | gratuit |
filmlab_get_documentation | aucune | gratuit |
filmlab_edit | generations:write et assets:write | par commande |
filmlab_export | generations:write | renvoie une génération |
Absents de la Direct API
| Outil MCP | À utiliser à la place |
|---|---|
list_models | Modèles |
get_credit_balance | GET /v1/direct/me |
get_generation_status, wait_for_generations, show_generation, show_asset | GET /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.