atlas-cloud

Atlas Cloud 是一个图像与视频生成/编辑技能，通过 Atlas Cloud 网关调用 Atlas 托管的多种模型完成完整的制作流程。

【用途与路由】该技能要求将完整制作路由到 image_selector 或 video_selector。当用户明确指定 Atlas Cloud 或某个确切的 Atlas 模型时，应直接调用 atlas_image 或 atlas_video；不得用直连厂商端点替代 Atlas 请求。

【配置与环境】需设置 ATLASCLOUD_API_KEY，并兼容接受别名 ATLAS_CLOUD_API_KEY 与 ATLAS_API_KEY。

【付费调用预检】每次付费调用前需读取 tool.get_info()["model_catalog"]，不得从搜索集合推断可用性，也不得臆造任务后缀。需选择目录所支持的确切模型 id 与操作，并在提交前公告 Atlas 工具、提供方、确切模型、请求数量与预估成本。可使用本地路径输入，工具会通过 Atlas 上传；输出应保存在当前 projects/<project-id>/ 目录树内并检查。资料还说明，在报价或批量花费前，应从机器可读模型页（Accept: text/markdown）确认当前定价与 schema。

【视频路由】

Seedance 2.5：支持文生、图生、参考生视频，路由为 bytedance/seedance-2.5/{text,image,reference}-to-video；image 模式使用一张图加可选 last_image；reference 模式最多接受 30 张图、10 个视频、10 个音频（含纯音频）；时长 4–30s；价格为 $0.134/s。
Seedance 2.0：支持文生、图生、参考生视频，路由为 bytedance/seedance-2.0/{text,image,reference}-to-video；时长 4–15s；价格为 $0.112/s。
Gemini Omni Flash：支持文生、图生、参考生视频及视频编辑。标准路由使用 google/gemini-omni-flash/...；开发者路由仅存在文生/图生/参考。标准 image 模式使用一张图；标准 reference 使用图片；开发者 reference 需要一个 video_clips 对象。
MiniMax H3：支持文生、图生、参考生视频，路由为 minimax/h3/{text,image,reference}-to-video；image 模式支持可选 end_image；reference 模式要求 refers 对象；时长 4–15s；768P/2K；价格为 $0.10/s。

视频调用使用规范的 OpenMontage 字段，例如 prompt、model、operation、duration、resolution、reference_images、reference_audios、output_path。对于 Gemini 开发者参考视频，需传入带 url、start、ends 的 video_clips 对象；对于 H3，调用方可传入规范化的 reference_images、reference_videos、reference_audios，工具会将其转换为 refers。不得静默截断 duration、resolution 或 ratio，无效值必须在计费前失败并在错误中给出受支持选项。

【图像路由】

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 提供。示例中给出了以 google/nano-banana-2/edit 进行编辑的调用方式。

【结果与失败契约】两个工具都向 Atlas 提交、轮询返回的 prediction id、下载所有输出，并返回 ToolResult 溯源，包含提供方、确切模型、prediction id、提交参数、来源 URL、产物路径与预估成本。缺失密钥、不支持的路由、无效枚举、缺失媒体输入、预测失败、超时或下载失败，必须返回失败结果且不切换提供方。

技能介绍