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