Katalog alat
Temukan alat Direct API beserta JSON Schema-nya, dan lihat setiap alat v1 dengan cakupan yang dibutuhkannya.
Direct API dibuat dari definisi alat yang sama dengan server MCP Morphic, sehingga katalog yang disajikan API selalu katalog yang aktif, termasuk setiap model yang dapat digunakan paket Anda.
Menemukan alat
| Permintaan | Mengembalikan |
|---|---|
GET /v1/direct/tools | setiap alat yang dapat dipanggil kunci ini, dengan JSON Schema lengkapnya, sebagai { "tools": [ … ] } |
GET /v1/direct/tools/{tool_name} | satu entri dari daftar itu, sebagai { "tool": { … } } |
GET /v1/direct/openapi.json | dokumen OpenAPI 3.1 untuk seluruh API, dibuat dari definisi yang sama; gunakan untuk membuat klien bertipe |
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 }
}
]
}| Field | Arti |
|---|---|
charges_credits | alat dapat membelanjakan kredit; lihat Kredit dan pemakaian |
returns_generation | alat memulai pekerjaan asinkron yang Anda pantau sebagai generasi |
input_schema | JSON Schema dari input di body panggilan. Ketat: kunci yang tidak dikenal ditolak, bukan diabaikan. |
output_schema | JSON Schema dari result di respons. Terbuka: field baru dapat muncul. |
Alat di v1
GET /v1/direct/tools adalah daftar yang otoritatif dan selalu terbaru. Di v1:
Akun dan katalog (gratis)
| Alat | Cakupan | Fungsi |
|---|---|---|
list_voices | tidak ada | suara yang ditawarkan model ucapan, masing-masing dengan voice_id miliknya |
list_projects | projects:read | proyek Anda |
list_workflows, get_workflow | projects:read | alur kerja tersimpan |
list_characters | assets:read | karakter terlatih, dengan id yang diterima alat edit |
list_elements | assets:read | Element organisasi Anda (karakter dan gaya terlatih), dengan id yang diterima sebuah generasi sebagai referensi |
plan_media | assets:read | memvalidasi dan menghitung harga rencana multi-langkah; lihat Minta penawaran harga sebelum membelanjakan |
Pustaka (gratis)
| Alat | Cakupan | Fungsi |
|---|---|---|
list_assets | assets:read | unggahan, generasi, dan dokumen, dengan link; file yang Anda berikan lewat URL tercantum di sini |
list_generations | assets:read | generasi terbaru beserta status dan asetnya |
Gambar (berbayar, mengembalikan generasi)
Cakupan 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 (berbayar, mengembalikan generasi)
Cakupan 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 memotong seseorang atau objek bernama dari video ke latar belakang transparan. Alat ini hanya berjalan di paket Enterprise.
Audio (berbayar, mengembalikan generasi)
Cakupan 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, dan efek audio audio_equalize, audio_compress, audio_limit, audio_gate, audio_deess, audio_denoise, audio_reverb, audio_gain, dan audio_fade, yang masing-masing mengembalikan file audio baru dengan efek yang sudah diterapkan.
dub_media menerima media_asset_id (satu file audio atau video), target_language (satu tag BCP-47 seperti hi atau pt-BR; beberapa bahasa berarti beberapa panggilan), source_language opsional (dideteksi jika dihilangkan), keyterms opsional (nama dan istilah yang dipertahankan seperti diucapkan, masing-masing hingga 5 kata), dan model_id opsional. Di Morphic Dub (mdl_h2z5a7af7y50), alat ini mengembalikan video itu sendiri dengan gerak bibir selaras, dan tagihan saat mulai berupa estimasi yang diselesaikan sesuai yang dibelanjakan proses. Morphic Dub juga menerima voice_mode: "assigned" dengan voices (setiap pembicara sebagai aset gambar atau audio, atau deskripsi singkat, dengan voice_id dari list_voices untuk mdl_h2z5a7af7y50; hanya suara katalog), dan SRT berwaktu Anda sendiri sebagai source_transcript_asset_id (bahasa yang diucapkan) atau translation_asset_id (bahasa tujuan), lewat URL atau sebagai dokumen di pustaka Anda, dengan mode suara mana pun. Melalui MCP, ElevenLabs Dubbing (model_name: "ElevenLabs Dubbing") juga menerima kedua SRT itu, dengan suara asli: source_language wajib diisi bersamanya, dan terjemahan hanya bisa menyertai transkrip. Lihat Dubbing.
Analisis (berbayar, menjawab di dalam panggilan)
analyze_video dan analyze_audio membutuhkan cakupan generations:write dan assets:read. Keduanya tidak memulai generasi, dan tagihannya dikembalikan jika analisis gagal.
Timeline Compose
Alat dalam grup ini tetap memakai awalan filmlab_ pada namanya.
| Alat | Cakupan | Tagihan |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | gratis |
filmlab_create_timeline | assets:write | gratis |
filmlab_get_documentation | tidak ada | gratis |
filmlab_edit | generations:write dan assets:write | per perintah |
filmlab_export | generations:write | mengembalikan generasi |
Tidak ada di Direct API
| Alat MCP | Gunakan sebagai gantinya |
|---|---|
list_models | Model |
get_credit_balance | GET /v1/direct/me |
get_generation_status, wait_for_generations, show_generation, show_asset | GET /v1/direct/generations/{id} dan POST /v1/direct/generations/batch-get |
Jika Anda mengalami kendala atau memiliki pertanyaan, jangan ragu untuk menghubungi kami. Kami dengan senang hati akan membantu. Tulis kepada kami di support@morphic.com.