Tool-Katalog
Entdecken Sie die Tools der Direct API und ihre JSON-Schemas und sehen Sie jedes Tool von v1 mit der Berechtigung, die es benötigt.
Die Direct API wird aus denselben Tool-Definitionen erzeugt wie der Morphic MCP-Server. Der Katalog, den die API ausliefert, ist daher immer der aktuelle, einschließlich jedes Modells, das Ihr Tarif nutzen kann.
Die Tools entdecken
| Anfrage | Liefert |
|---|---|
GET /v1/direct/tools | jedes Tool, das dieser Schlüssel aufrufen kann, mit seinen vollständigen JSON-Schemas, als { "tools": [ … ] } |
GET /v1/direct/tools/{tool_name} | einen Eintrag dieser Liste, als { "tool": { … } } |
GET /v1/direct/openapi.json | ein OpenAPI-3.1-Dokument für die gesamte API, aus denselben Definitionen erstellt; nutzen Sie es, um einen typisierten Client zu generieren |
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 }
}
]
}| Feld | Bedeutung |
|---|---|
charges_credits | das Tool kann Credits verbrauchen; siehe Credits und Nutzung |
returns_generation | das Tool startet asynchrone Arbeit, die Sie als Generierung verfolgen |
input_schema | JSON-Schema von input im Body des Aufrufs. Strikt: Ein unbekannter Schlüssel wird abgelehnt, nicht ignoriert. |
output_schema | JSON-Schema von result in der Antwort. Offen: Neue Felder können hinzukommen. |
Tools in v1
GET /v1/direct/tools ist die maßgebliche, stets aktuelle Liste. In v1:
Konto und Katalog (kostenlos)
| Tool | Berechtigung | Funktion |
|---|---|---|
list_voices | keine | die Stimmen, die ein Sprachmodell anbietet, jeweils mit ihrer voice_id |
list_projects | projects:read | Ihre Projekte |
list_workflows, get_workflow | projects:read | gespeicherte Workflows |
list_characters | assets:read | trainierte Charaktere, mit der ID, die eine Bearbeitung annimmt |
plan_media | assets:read | einen mehrstufigen Plan prüfen und kalkulieren; siehe Vor dem Ausgeben kalkulieren |
Bibliothek (kostenlos)
| Tool | Berechtigung | Funktion |
|---|---|---|
list_assets | assets:read | Uploads, Generierungen und Dokumente, mit Links; eine Datei, die Sie per URL übergeben haben, erscheint hier |
list_generations | assets:read | aktuelle Generierungen mit Status und Assets |
Bild (kostenpflichtig, liefert Generierungen)
Berechtigung 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 (kostenpflichtig, liefert Generierungen)
Berechtigung 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 (kostenpflichtig, liefert Generierungen)
Berechtigung 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.
Analyse (kostenpflichtig, Antwort im Aufruf)
analyze_video und analyze_audio benötigen die Berechtigungen generations:write und assets:read. Sie starten keine Generierung, und die Belastung wird erstattet, wenn die Analyse fehlschlägt.
Compose-Timelines
Die Tools dieser Gruppe behalten das Präfix filmlab_ in ihrem Namen.
| Tool | Berechtigung | Kosten |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | kostenlos |
filmlab_create_timeline | assets:write | kostenlos |
filmlab_get_documentation | keine | kostenlos |
filmlab_edit | generations:write und assets:write | pro Befehl |
filmlab_export | generations:write | liefert eine Generierung |
Nicht in der Direct API
| MCP-Tool | Stattdessen verwenden |
|---|---|
list_models | Modelle |
get_credit_balance | GET /v1/direct/me |
get_generation_status, wait_for_generations, show_generation, show_asset | GET /v1/direct/generations/{id} und POST /v1/direct/generations/batch-get |
Wenn Sie Probleme haben oder Fragen haben, können Sie sich gerne an uns wenden. Wir helfen Ihnen gerne. Schreiben Sie uns an support@morphic.com.