mcpField
A
atlas-cloud

atlas-cloud

github.com/calesthio创意与媒体73.0k663 次安装1 天前更新
代码仓库

关于 atlas-cloud

这是一项在 OpenMontage 中通过 Atlas Cloud 路由图像和视频制作的技能，说明支持的模型路线、输入处理、调用前检查及结果溯源。失败时须报告错误，不得切换提供方。

主要功能

  1. 01Atlas 图像与视频路线
  2. 02模型目录和操作检查
  3. 03图像及媒体参考输入
  4. 04预测轮询与结果下载
  5. 05结果溯源和成本估算

适用场景

  1. 01通过 Atlas Cloud 路由制作任务
  2. 02选择目录支持的模型操作
  3. 03提交图像或视频参考输入
  4. 04检查生成文件及调用来源

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/calesthio/openmontage --skill atlas-cloud

安装后在 Claude Code 中输入/atlas-cloud确认已加载。

详细介绍

Atlas Cloud

通过 image_selector 或 video_selector 路由完整制作任务。当用户指定 Atlas Cloud 或某个确切的 Atlas 模型时，直接调用 atlas_image 或 atlas_video。对于 Atlas 请求，绝不能改用供应商的直接端点。

设置 ATLASCLOUD_API_KEY。为保持兼容性，也接受别名 ATLAS_CLOUD_API_KEY 和 ATLAS_API_KEY。

每次付费调用前的检查

  1. 读取 tool.get_info()["model_catalog"]；不要根据搜索集合推断可用性，也不要虚构任务后缀。
  2. 选择该目录支持的确切模型 ID 和操作。
  3. 提交前，告知用户 Atlas 工具、供应商、确切模型、请求数量和预估费用。
  4. 方便时使用本地路径输入。工具会通过 Atlas 上传这些文件。
  5. 将输出保存在当前活动项目的 projects/<project-id>/ 目录树中，并检查输出。

视频路由

系列操作确切路由说明
Seedance 2.5文本、图像、参考bytedance/seedance-2.5/{text,image,reference}-to-video；图像模式使用 image，并可选使用 last_image；参考模式最多接受 30 张图像、10 个视频和 10 个音频（包括纯音频）；4–30 秒；$0.134/秒
Seedance 2.0文本、图像、参考bytedance/seedance-2.0/{text,image,reference}-to-video；4–15 秒；$0.112/秒
Gemini Omni Flash文本、图像、参考、视频编辑标准路由使用 google/gemini-omni-flash/...；仅文本、图像和参考有开发者路由。标准图像模式使用一个 image；标准参考模式使用 images；开发者参考模式需要一个 video_clips 对象。
MiniMax H3文本、图像、参考minimax/h3/{text,image,reference}-to-video；图像模式支持可选的 end_image；参考模式需要 refers 对象；4–15 秒；768P/2K；$0.10/秒

使用规范的 OpenMontage 字段：

tool.execute({
    "prompt": "...",
    "model": "minimax/h3/reference-to-video",
    "operation": "reference_to_video",
    "duration": 10,
    "resolution": "2K",
    "reference_images": ["projects/demo/character.png"],
    "reference_audios": ["projects/demo/performance.wav"],
    "output_path": "projects/demo/h3.mp4",
})

对于 Gemini 开发者参考视频，传入包含 url、 start 和 ends 的 video_clips 对象。对于 H3，调用方可以传入规范化的 reference_images、reference_videos 和 reference_audios；工具会将它们转换为 refers。

不要静默限制时长、分辨率或宽高比。无效值必须在计费前导致失败，并在错误中列出支持的选项。

图像路由

系列操作确切路由说明
Seedream 5.0 Pro生成、编辑、分解bytedance/seedream-v5.0-pro/text-to-image、/edit、/layer-decomposition；编辑最多接受 10 张图像；尺寸使用 WIDTH*HEIGHT
Seedream 5.0 Lite编辑bytedance/seedream-v5.0-lite/edit；不要假定存在可用的 Lite 文本转图像同系列路由；最多接受 14 张图像
GPT Image 2生成、编辑openai/gpt-image-2/text-to-image、/edit；尺寸使用 WIDTHxHEIGHT；编辑最多接受 10 张图像
Nano Banana 2生成、编辑google/nano-banana-2/text-to-image、/edit；使用宽高比和 1k/2k/4k 分辨率；编辑最多接受 14 张图像

将 generation_mode 设为 generate、edit 或 decompose。源图像可以通过 image_path、image_paths、image_url 或 image_urls 提供。

tool.execute({
    "prompt": "Replace the packaging with matte cobalt glass; preserve the logo",
    "model": "google/nano-banana-2/edit",
    "generation_mode": "edit",
    "image_paths": ["projects/campaign/source.png"],
    "resolution": "2k",
    "output_path": "projects/campaign/revised.png",
})

结果与失败约定

两个工具都会向 Atlas 提交请求、轮询返回的预测 ID、下载所有输出，并返回包含供应商、确切模型、预测 ID、已提交参数、源 URL、产物路径和预估费用的 ToolResult 来源信息。缺少密钥、路由不受支持、枚举值无效、缺少媒体输入、预测失败、超时或下载失败时，必须返回失败结果，且不得切换供应商。

在引用价格或为批量任务付费前，请立即通过机器可读的模型页面（Accept: text/markdown）确认当前价格和架构。

评论

支持 Markdown