工具目录
了解 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.