도구 카탈로그
Direct API의 도구와 JSON Schema를 확인하고, v1의 모든 도구와 각 도구에 필요한 범위를 알아봅니다.
Direct API는 Morphic MCP 서버와 같은 도구 정의에서 생성되므로, API가 제공하는 카탈로그는 플랜에서 사용할 수 있는 모든 모델을 포함해 항상 최신 상태입니다.
도구 확인하기
| 요청 | 반환 |
|---|---|
GET /v1/direct/tools | 이 키로 호출할 수 있는 모든 도구와 전체 JSON Schema를 { "tools": [ … ] } 형태로 반환 |
GET /v1/direct/tools/{tool_name} | 그 목록의 항목 하나를 { "tool": { … } } 형태로 반환 |
GET /v1/direct/openapi.json | 같은 정의로 만든 API 전체의 OpenAPI 3.1 문서. 타입이 지정된 클라이언트를 생성할 때 사용 |
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 }
}
]
}| 필드 | 의미 |
|---|---|
charges_credits | 도구가 크레딧을 사용할 수 있음. 크레딧과 사용량 참조 |
returns_generation | 도구가 생성 작업으로 추적하는 비동기 작업을 시작함 |
input_schema | 호출 본문의 input에 대한 JSON Schema. 엄격함: 알 수 없는 키는 무시되지 않고 거부됩니다. |
output_schema | 응답의 result에 대한 JSON Schema. 개방형: 새 필드가 나타날 수 있습니다. |
v1의 도구
GET /v1/direct/tools가 권위 있는, 항상 최신 상태의 목록입니다. v1 기준:
계정과 카탈로그(무료)
| 도구 | 범위 | 기능 |
|---|---|---|
list_voices | 없음 | 음성 모델이 제공하는 음성과 각 음성의 voice_id |
list_projects | projects:read | 프로젝트 |
list_workflows, get_workflow | projects:read | 저장된 워크플로 |
list_characters | assets:read | 학습된 캐릭터와 편집에 사용하는 ID |
plan_media | assets:read | 여러 단계로 된 계획을 검증하고 견적 받기. 사용 전에 견적 받기 참조 |
라이브러리(무료)
| 도구 | 범위 | 기능 |
|---|---|---|
list_assets | assets:read | 업로드, 생성 결과, 문서와 그 링크; URL로 전달한 파일도 여기에 표시됩니다 |
list_generations | assets:read | 최근 생성 작업과 상태 및 에셋 |
이미지(유료, 생성 작업 반환)
범위 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.
동영상(유료, 생성 작업 반환)
범위 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.
오디오(유료, 생성 작업 반환)
범위 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.
분석(유료, 호출 안에서 응답)
analyze_video와 analyze_audio에는 generations:write와 assets:read 범위가 필요합니다. 이 도구들은 생성 작업을 시작하지 않으며, 분석이 실패하면 청구 금액이 환불됩니다.
Compose 타임라인
이 그룹의 도구는 이름에 filmlab_ 접두사를 그대로 사용합니다.
| 도구 | 범위 | 청구 |
|---|---|---|
filmlab_list_timelines, filmlab_read_timeline | projects:read | 무료 |
filmlab_create_timeline | assets:write | 무료 |
filmlab_get_documentation | 없음 | 무료 |
filmlab_edit | generations:write와 assets:write | 명령별 |
filmlab_export | generations:write | 생성 작업 반환 |
Direct API에 없는 도구
| MCP 도구 | 대신 사용할 것 |
|---|---|
list_models | 모델 |
get_credit_balance | GET /v1/direct/me |
get_generation_status, wait_for_generations, show_generation, show_asset | GET /v1/direct/generations/{id}와 POST /v1/direct/generations/batch-get |
문제가 있거나 궁금한 점이 있으면 언제든지 연락해 주세요. 기꺼이 도와드리겠습니다. 다음 주소로 이메일을 보내 주세요: support@morphic.com.