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

SolicitudDevuelve
GET /v1/direct/toolstodas 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.jsonun 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 }
    }
  ]
}
CampoSignificado
charges_creditsla herramienta puede gastar créditos; consulte Créditos y uso
returns_generationla herramienta inicia trabajo asíncrono que usted sigue como una generación
input_schemaJSON Schema de input en el cuerpo de la llamada. Estricto: una clave desconocida se rechaza, no se ignora.
output_schemaJSON 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)

HerramientaPermisoQué hace
list_voicesningunolas voces que ofrece un modelo de voz, cada una con su voice_id
list_projectsprojects:readsus proyectos
list_workflows, get_workflowprojects:readflujos de trabajo guardados
list_charactersassets:readpersonajes entrenados, con el id que recibe una edición
list_elementsassets:readlos Elementos de su organización (personajes y estilos entrenados), con el id que una generación recibe como referencia
plan_mediaassets:readvalidar y presupuestar un plan de varios pasos; consulte Presupueste antes de gastar

Biblioteca (gratis)

HerramientaPermisoQué hace
list_assetsassets:readsubidas, generaciones y documentos, con enlaces; aquí aparece un archivo que usted indicó por URL
list_generationsassets:readgeneraciones 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.

HerramientaPermisoCobro
filmlab_list_timelines, filmlab_read_timelineprojects:readgratis
filmlab_create_timelineassets:writegratis
filmlab_get_documentationningunogratis
filmlab_editgenerations:write y assets:writepor comando
filmlab_exportgenerations:writedevuelve una generación

No disponibles en la Direct API

Herramienta MCPUse en su lugar
list_modelsModelos
get_credit_balanceGET /v1/direct/me
get_generation_status, wait_for_generations, show_generation, show_assetGET /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.

En esta página