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ção | Retorna |
|---|---|
GET /v1/direct/tools | todas 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.json | um 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 }
}
]
}| Campo | Significado |
|---|---|
charges_credits | a ferramenta pode gastar créditos; veja Créditos e uso |
returns_generation | a ferramenta inicia um trabalho assíncrono que você acompanha como uma geração |
input_schema | JSON Schema do input no corpo da chamada. Estrito: uma chave desconhecida é recusada, não ignorada. |
output_schema | JSON 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)
| Ferramenta | Escopo | O que faz |
|---|---|---|
list_voices | nenhum | as vozes que um modelo de fala oferece, cada uma com o seu voice_id |
list_projects | projects:read | os seus projetos |
list_workflows, get_workflow | projects:read | workflows salvos |
list_characters | assets:read | personagens treinados, com o ID que uma edição recebe |
plan_media | assets:read | validar e orçar um plano de várias etapas; veja Orce antes de gastar |
Biblioteca (gratuitas)
| Ferramenta | Escopo | O que faz |
|---|---|---|
list_assets | assets:read | envios, gerações e documentos, com links; um arquivo que você informou por URL aparece aqui |
list_generations | assets:read | geraçõ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.
Á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.
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.
| Ferramenta | Escopo | Cobrança |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | gratuita |
filmlab_create_timeline | assets:write | gratuita |
filmlab_get_documentation | nenhum | gratuita |
filmlab_edit | generations:write e assets:write | por comando |
filmlab_export | generations:write | retorna uma geração |
Fora da Direct API
| Ferramenta do MCP | Use no 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} 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.