用途:当用户希望用 Cosmos3 生成图像或视频、询问推理参数/输入格式/并行方式、搭建在线服务(Ray Serve、Gradio),或咨询提示词工程与上采样时使用。环境或导入错误应转交 cosmos3-env-troubleshoot。
主要能力与查阅路径:所有路径相对 cosmos3 包根目录(本技能文件向上三级),uv run / python 命令也需在该目录执行。单卡/多卡推理、并行预设(延迟与吞吐)见 README.md 的 Inference 节;模型选择(Nano 与 Super、显存、shift)见 Models 节;模态(t2i、t2v、i2v 及示例)见 Modalities 节。输入字段(prompt、vision_path、num_frames 等)见 docs/inference.md 的 Sample Arguments;各模态默认值见 cosmos_framework/inference/defaults/<model_mode>/sample_args.json;自定义默认值与参数覆盖优先级见 docs/inference.md 与 docs/faq.md。帧数上限、shift 参数、Ray 在线推理、提示词上采样见 docs/faq.md。底层 API 见 examples/inference.py(模型 API)与 examples/inference_pipeline.py(管道 API)。全部 CLI 参数可用 uv run --all-extras --group=cu130 python -m cosmos_framework.scripts.inference --help 查看。
使用要点:输入 JSON 中的相对路径按该 JSON 文件所在目录解析,而非工作目录;需可复现结果时应始终传 --seed,否则每次随机;中断后可重跑同一命令续跑,已有输出自动跳过;--keep-going 可在单样本失败(如护栏拒绝)后继续处理其余样本,在线服务默认启用;每次运行中每个样本的 name 字段必须唯一,否则脚本报错。
相关技能:安装与环境见 cosmos3-setup,代码文件与配置查找见 cosmos3-codebase-nav,环境与运行时错误调试见 cosmos3-env-troubleshoot。具体模型规格、收费与平台支持等资料暂未提供。