用途：通过命令行以 API 方式调用 Gradio 应用，适用于需要从 Hugging Face Spaces 或公开 URL 的 Gradio 应用生成预测的场景。
主要能力：提供 info 与 predict 两个命令。info 返回 JSON，描述所有端点、参数（含类型与默认值）及返回值；predict 提交 JSON 载荷并返回带命名输出键的 JSON 结果。支持文件类型参数（type 为 filepath，需带 meta 的 _type 为 gradio.FileData），并可通过 --token 访问私有 Spaces。
使用方式：先确认当前虚拟环境已安装 hf-gradio 或 gradio；若使用 hf CLI，可通过 hf extensions install gradio-app/hf-gradio 安装扩展。查询接口用 gradio info <space_id_or_url>（或 hf-gradio info、hf gradio info）。生成预测用 gradio predict <space_id_or_url> <endpoint> <json_payload>（或 hf-gradio predict、hf gradio predict）。
适用场景：从 Gradio 应用获取数值、图像等预测结果，例如 gradio predict gradio/calculator /predict '{"num1": 5, "operation": "multiply", "num2": 3}' 返回 {"output": 15}；图像生成如 gradio predict black-forest-labs/FLUX.2-dev /infer '{"prompt": "A majestic dragon"}'；文件上传需包含 meta 键。
限制：资料未提供收费、价格、平台支持范围、性能或效果等信息；使用前需确保命令已安装，私有 Space 需提供 token。