Araç kataloğu
Direct API'nin araçlarını ve JSON Şemalarını keşfedin ve her v1 aracını gerektirdiği kapsamla birlikte görün.
Direct API, Morphic MCP sunucusuyla aynı araç tanımlarından üretilir; bu yüzden API'nin sunduğu katalog, planınızın kullanabildiği her model dahil olmak üzere her zaman canlı katalogdur.
Araçları keşfedin
| İstek | Döndürdüğü |
|---|---|
GET /v1/direct/tools | bu anahtarın çağırabildiği her araç, tam JSON Şemalarıyla, { "tools": [ … ] } olarak |
GET /v1/direct/tools/{tool_name} | bu listenin tek bir girdisi, { "tool": { … } } olarak |
GET /v1/direct/openapi.json | aynı tanımlardan oluşturulan, tüm API için bir OpenAPI 3.1 belgesi; tipli bir istemci üretmek için kullanın |
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 }
}
]
}| Alan | Anlamı |
|---|---|
charges_credits | araç kredi harcayabilir; bkz. Krediler ve kullanım |
returns_generation | araç, bir üretim olarak takip ettiğiniz eşzamansız bir iş başlatır |
input_schema | çağrı gövdesindeki input için JSON Şeması. Katıdır: bilinmeyen bir anahtar yok sayılmaz, reddedilir. |
output_schema | yanıttaki result için JSON Şeması. Açıktır: yeni alanlar görünebilir. |
v1'deki araçlar
GET /v1/direct/tools, yetkili ve her zaman güncel listedir. v1'de:
Hesap ve katalog (ücretsiz)
| Araç | Kapsam | İşlevi |
|---|---|---|
list_voices | yok | bir konuşma modelinin sunduğu sesler, her biri voice_id değeriyle |
list_projects | projects:read | projeleriniz |
list_workflows, get_workflow | projects:read | kaydedilmiş iş akışları |
list_characters | assets:read | eğitilmiş karakterler, bir düzenlemenin aldığı kimlikle |
plan_media | assets:read | çok adımlı bir planı doğrular ve fiyatlandırır; bkz. Harcamadan önce fiyat alın |
Kütüphane (ücretsiz)
| Araç | Kapsam | İşlevi |
|---|---|---|
list_assets | assets:read | yüklemeler, üretimler ve belgeler, bağlantılarıyla; URL ile verdiğiniz bir dosya burada listelenir |
list_generations | assets:read | durumları ve varlıklarıyla son üretimler |
Görsel (ücretli, üretim döndürür)
Kapsam 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 (ücretli, üretim döndürür)
Kapsam 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.
Ses (ücretli, üretim döndürür)
Kapsam 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.
Analiz (ücretli, çağrı içinde yanıt verir)
analyze_video ve analyze_audio, generations:write ve assets:read kapsamlarını gerektirir. Üretim başlatmazlar ve analiz başarısız olursa ücret iade edilir.
Compose zaman çizelgeleri
Bu gruptaki araçların adları filmlab_ önekini korur.
| Araç | Kapsam | Ücret |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | ücretsiz |
filmlab_create_timeline | assets:write | ücretsiz |
filmlab_get_documentation | yok | ücretsiz |
filmlab_edit | generations:write ve assets:write | komut başına |
filmlab_export | generations:write | üretim döndürür |
Direct API'de olmayanlar
| MCP aracı | Bunun yerine kullanın |
|---|---|
list_models | Modeller |
get_credit_balance | GET /v1/direct/me |
get_generation_status, wait_for_generations, show_generation, show_asset | GET /v1/direct/generations/{id} ve POST /v1/direct/generations/batch-get |
Herhangi bir sorun yaşarsanız ya da sorularınız olursa, bizimle iletişime geçmekten çekinmeyin. Yardım etmeye memnuniyet duyarız. Bize şu adresten yazın: support@morphic.com.