Catálogo de ferramentas

Descubra as ferramentas da Direct API e seus JSON Schemas, e veja todas as ferramentas da v1 com o escopo de que cada uma precisa.

A Direct API é gerada a partir das mesmas definições de ferramentas do servidor MCP do Morphic, então o catálogo que a API serve é sempre o atual, incluindo todos os modelos que o seu plano pode usar.

Descobrir as ferramentas

SolicitaçãoRetorna
GET /v1/direct/toolstodas as ferramentas que esta chave pode chamar, com seus JSON Schemas completos, como { "tools": [ … ] }
GET /v1/direct/tools/{tool_name}uma entrada dessa lista, como { "tool": { … } }
GET /v1/direct/openapi.jsonum documento OpenAPI 3.1 de toda a API, gerado a partir das mesmas definições; use-o para gerar um 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_creditsa ferramenta pode gastar créditos; veja Créditos e uso
returns_generationa ferramenta inicia um trabalho assíncrono que você acompanha como uma geração
input_schemaJSON Schema do input no corpo da chamada. Estrito: uma chave desconhecida é recusada, não ignorada.
output_schemaJSON Schema do result na resposta. Aberto: novos campos podem aparecer.

Ferramentas na v1

GET /v1/direct/tools é a lista oficial e sempre atualizada. Na v1:

Conta e catálogo (gratuitas)

FerramentaEscopoO que faz
list_voicesnenhumas vozes que um modelo de fala oferece, cada uma com o seu voice_id
list_projectsprojects:reados seus projetos
list_workflows, get_workflowprojects:readworkflows salvos
list_charactersassets:readpersonagens treinados, com o ID que uma edição recebe
list_elementsassets:reados Elementos da sua organização (personagens e estilos treinados), com o ID que uma geração recebe como referência
plan_mediaassets:readvalidar e orçar um plano de várias etapas; veja Orce antes de gastar

Biblioteca (gratuitas)

FerramentaEscopoO que faz
list_assetsassets:readenvios, gerações e documentos, com links; um arquivo que você informou por URL aparece aqui
list_generationsassets:readgerações recentes com status e recursos

Imagem (pagas, retornam gerações)

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

Vídeo (pagas, retornam gerações)

Escopo 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 uma pessoa ou objetos nomeados de um vídeo e os coloca sobre um fundo transparente. Roda apenas em planos Enterprise.

Áudio (pagas, retornam gerações)

Escopo 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, e os efeitos de áudio audio_equalize, audio_compress, audio_limit, audio_gate, audio_deess, audio_denoise, audio_reverb, audio_gain e audio_fade, que devolvem, cada um, um novo arquivo de áudio com o efeito aplicado.

dub_media recebe media_asset_id (um arquivo de áudio ou vídeo), target_language (uma tag BCP-47, como hi ou pt-BR; vários idiomas são várias chamadas), uma source_language opcional (detectada quando omitida), keyterms opcionais (nomes e termos a manter como falados, com até 5 palavras cada) e um model_id opcional. No Morphic Dub (mdl_h2z5a7af7y50), ela devolve o próprio vídeo, com os lábios sincronizados, e a cobrança no início é uma estimativa acertada pelo gasto da execução. O Morphic Dub também recebe voice_mode: "assigned" com voices (cada falante como um ativo de imagem ou de áudio ou uma descrição curta, com um voice_id de list_voices para mdl_h2z5a7af7y50; apenas vozes do catálogo), e o seu próprio SRT com tempos como source_transcript_asset_id (idioma falado) ou translation_asset_id (idioma de destino), por URL ou como documento na sua biblioteca, em qualquer um dos dois modos de voz. Pelo MCP, o ElevenLabs Dubbing (model_name: "ElevenLabs Dubbing") também recebe os dois SRTs, nas vozes originais: source_language é obrigatório com eles, e a tradução vai apenas junto com a transcrição. Veja Dublagem.

Análise (pagas, respondem na chamada)

analyze_video e analyze_audio exigem os escopos generations:write e assets:read. Elas não iniciam nenhuma geração, e a cobrança é reembolsada se a análise falhar.

Linhas do tempo do Compose

As ferramentas deste grupo mantêm o prefixo filmlab_ no nome.

FerramentaEscopoCobrança
filmlab_list_timelines, filmlab_read_timelineprojects:readgratuita
filmlab_create_timelineassets:writegratuita
filmlab_get_documentationnenhumgratuita
filmlab_editgenerations:write e assets:writepor comando
filmlab_exportgenerations:writeretorna uma geração

Fora da Direct API

Ferramenta do MCPUse no lugar
list_modelsModelos
get_credit_balanceGET /v1/direct/me
get_generation_status, wait_for_generations, show_generation, show_assetGET /v1/direct/generations/{id} e POST /v1/direct/generations/batch-get

Se você tiver algum problema ou alguma dúvida, entre em contato. Teremos prazer em ajudar. Escreva para nós em support@morphic.com.

Nesta página