Api: 传入你自己的媒体

在任何接收媒体的字段中，通过 URL 将你自己的图片、视频、音频和文档提供给 Morphic。

每个接收媒体的字段（image_asset_id、reference_video_asset_ids、asset_id，以及其他所有 *_asset_id 或 *_asset_ids）都可以接收素材库中的素材 ID，或文件的公开 HTTPS URL。你可以在同一次调用中自由混用两者。无需单独的上传步骤。

curl -s https://mcp.morphic.com/v1/direct/tools/edit_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Put the bike on a beach at sunset", "image_asset_ids": ["https://cdn.example.com/products/bike.jpg"], "project_id": "01928f4e-…"}}'

在工具运行之前，每个 URL 都会被获取，并作为上传素材免费添加到 project_id。之后，工具会像处理其他素材一样处理它。传入 URL 需要 assets:write 权限范围，每个不同的 URL 计为免费调用额度中的一次调用。

URL 必须是公共主机上的 HTTPS 地址，并直接提供文件本身，而不是网页。
对于你自己存储中的文件，请传入签名 URL（S3 预签名 GET、GCS 签名 URL）。请确保它在调用返回前一直有效。
支持图片、视频、音频和文档（.pdf、.txt、.md、.srt）。系统会检测文件字节，因此从不信任扩展名。
媒体文件最大 100 MB（如果你的套餐上传上限更低，则以该上限为准），并且必须在 25 秒内传输完成。
同一次调用中出现两次的 URL 只会获取一次。之后的调用会再次获取；如需复用文件而不再次获取，请传入 list_assets 为它显示的素材 ID。
在获取任何 URL 之前，系统会按照工具的 schema 校验调用的输入。格式错误的调用会返回 400 invalid_request，且不会获取任何内容。
无法获取或不被接受的 URL 会返回 422 tool_refused 并指明字段，例如 input.image_asset_ids[0]: The URL must use https. 不会启动任何任务，也不会收费。已添加的文件会保留在项目中，与工具本身随后拒绝调用时的情况相同。
analyze_video 和 analyze_audio 接收 project_id 仅为此用途：当媒体字段包含 URL 时请发送它。
plan_media 的步骤同样接受 URL，每个 URL 会添加到其所在步骤的 project_id，因此报价会将这些文件添加到你的素材库。对于你实际运行的步骤，请传入 list_assets 随后显示的素材 ID，而不是 URL，这样每个文件只需获取一次。

如果您遇到任何问题或有任何疑问，欢迎随时联系我们。我们很乐意提供帮助。请发送邮件至 support@morphic.com.