#MCP 工具与使用示例

完成 MCP 连接后，客户端可以发现下面五个工具。以下 JSON 是对应工具的参数，不是直接发往模型 API 的 HTTP 请求体。

#工具列表

generate_media 目前是图片工具，不是视频工具。目录中可以查到视频模型，不能据此认为 MCP 能直接生成视频。

#搜索与查看详情

search_models 示例：

{"query":"seedance","type":"video","limit":5}

默认每页 5 项，limit 范围为 1–10。需要下一页时使用返回的 nextCursor，保持原过滤条件不变。供应商与 endpoint 过滤是准确匹配。

将搜索返回的准确 ID 用于 get_model：

{"model":"YOUR_MODEL_ID","sections":["summary","pricing","calling","usage"]}

calling 区段说明是否支持 MCP 生成、适用工具及原因。usage 区段可包含计费维度，供查价时使用。

#比较价格

调用 compare_models，最多提供 5 个模型：

{"models":["YOUR_MODEL_A","YOUR_MODEL_B"],"inputTokens":1000,"outputTokens":500}

视频等任务模型还可能需要 durationSeconds、resolution 或 usage 事实。必须按模型 schema 填写；缺少条件或自定义定价时可能无法估算，不要把空结果当作免费。

#生成文本与图片

generate_text：

{"model":"YOUR_TEXT_MODEL","prompt":"Summarize what an API gateway does","maxTokens":256}

generate_media：

{"model":"YOUR_IMAGE_MODEL","prompt":"A small lighthouse at sunrise","n":1,"responseFormat":"url"}

生成工具只接受其 schema 中的参数，不要添加 apiKey；认证来自连接请求头。先核对目标、数量与费用，再允许客户端执行。

#理解结果

status: "ok" 表示收到工具结果。outcome_unknown 表示请求可能已经执行但结果丢失；先查看调用日志，不要自动重试。失败也可能通过 MCP 的 isError 返回，不能只检查 HTTP 状态。

cost 是目录标价的本地估算，不是实际扣费；模型分组、条件和最终用量会造成差异。实际用量以控制台为准。保留 requestId 排错，图片 URL 应及时保存。