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 |
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.
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.
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.