Catálogo de herramientas
Descubra las herramientas de la Direct API y sus JSON Schemas, y vea cada herramienta de v1 con el permiso que necesita.
La Direct API se genera a partir de las mismas definiciones de herramientas que el servidor MCP de Morphic, así que el catálogo que sirve la API es siempre el vigente, incluidos todos los modelos que su plan puede usar.
Descubrir las herramientas
| Solicitud | Devuelve |
|---|---|
GET /v1/direct/tools | todas las herramientas que esta clave puede llamar, con sus JSON Schemas completos, como { "tools": [ … ] } |
GET /v1/direct/tools/{tool_name} | una entrada de esa lista, como { "tool": { … } } |
GET /v1/direct/openapi.json | un documento OpenAPI 3.1 de toda la API, creado a partir de las mismas definiciones; úselo para generar un cliente tipado |
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 }
}
]
}| Campo | Significado |
|---|---|
charges_credits | la herramienta puede gastar créditos; consulte Créditos y uso |
returns_generation | la herramienta inicia trabajo asíncrono que usted sigue como una generación |
input_schema | JSON Schema de input en el cuerpo de la llamada. Estricto: una clave desconocida se rechaza, no se ignora. |
output_schema | JSON Schema de result en la respuesta. Abierto: pueden aparecer campos nuevos. |
Herramientas en v1
GET /v1/direct/tools es la lista de referencia, siempre actualizada. En v1:
Cuenta y catálogo (gratis)
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_voices | ninguno | las voces que ofrece un modelo de voz, cada una con su voice_id |
list_projects | projects:read | sus proyectos |
list_workflows, get_workflow | projects:read | flujos de trabajo guardados |
list_characters | assets:read | personajes entrenados, con el id que recibe una edición |
list_elements | assets:read | los Elementos de su organización (personajes y estilos entrenados), con el id que una generación recibe como referencia |
plan_media | assets:read | validar y presupuestar un plan de varios pasos; consulte Presupueste antes de gastar |
Biblioteca (gratis)
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_assets | assets:read | subidas, generaciones y documentos, con enlaces; aquí aparece un archivo que usted indicó por URL |
list_generations | assets:read | generaciones recientes con su estado y sus recursos |
Imagen (de pago, devuelven generaciones)
Permiso 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.
Video (de pago, devuelven generaciones)
Permiso 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 recorta a una persona u objetos con nombre de un video sobre un fondo transparente. Solo funciona en los planes Enterprise.
Audio (de pago, devuelven generaciones)
Permiso 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 y los efectos de audio audio_equalize, audio_compress, audio_limit, audio_gate, audio_deess, audio_denoise, audio_reverb, audio_gain y audio_fade, que devuelven cada uno un archivo de audio nuevo con el efecto aplicado.
dub_media recibe media_asset_id (un archivo de audio o video), target_language (una etiqueta BCP-47 como hi o pt-BR; varios idiomas son varias llamadas), un source_language opcional (se detecta si se omite), keyterms opcionales (nombres y términos que se mantienen como se dicen, de hasta 5 palabras cada uno) y un model_id opcional. En Morphic Dub (mdl_h2z5a7af7y50) devuelve el propio video, con los labios sincronizados, y el cobro inicial es una estimación que se liquida según el gasto de la ejecución. Morphic Dub también recibe voice_mode: "assigned" con voices (cada hablante como un activo de imagen o de audio o una descripción breve, con un voice_id de list_voices para mdl_h2z5a7af7y50; solo voces del catálogo), y su propio SRT con tiempos como source_transcript_asset_id (idioma hablado) o translation_asset_id (idioma de destino), por URL o como documento de su biblioteca, con cualquiera de los dos modos de voz. Por MCP, ElevenLabs Dubbing (model_name: "ElevenLabs Dubbing") recibe también los dos SRT, con las voces originales: source_language es obligatorio con ellos, y la traducción va solo con la transcripción. Consulte Doblaje.
Análisis (de pago, responden dentro de la llamada)
analyze_video y analyze_audio necesitan los permisos generations:write y assets:read. No inician ninguna generación, y el cobro se reembolsa si el análisis falla.
Líneas de tiempo de Compose
Las herramientas de este grupo conservan el prefijo filmlab_ en su nombre.
| Herramienta | Permiso | Cobro |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | gratis |
filmlab_create_timeline | assets:write | gratis |
filmlab_get_documentation | ninguno | gratis |
filmlab_edit | generations:write y assets:write | por comando |
filmlab_export | generations:write | devuelve una generación |
No disponibles en la Direct API
| Herramienta MCP | Use en su lugar |
|---|---|
list_models | Modelos |
get_credit_balance | GET /v1/direct/me |
get_generation_status, wait_for_generations, show_generation, show_asset | GET /v1/direct/generations/{id} y POST /v1/direct/generations/batch-get |
Si tiene algún problema o alguna pregunta, no dude en ponerse en contacto con nosotros. Estaremos encantados de ayudarle. Escríbanos a support@morphic.com.