用途
ai-media CLI 用于安装、配置、引导新用户以及自动化调用 ai-media 命令行工具,目标平台包括 ricebowl.ai、sora2.cloud 或兼容的本地 API。它适合需要以命令行方式接入媒体生成服务、进行脚本化或自动化调用的场景。
主要能力
- 安装与配置 ai-media CLI。
- 对接 ricebowl.ai、sora2.cloud 或本地兼容 API。
- 讲解命令参数、常用用法与脚本化调用。
- 引导新用户完成充值、生成 key、写入配置等 onboarding 流程。
- 生成图片与视频任务,并按任务 ID 查询结果。
- 列出可用模型,支持 JSON 输出以便脚本处理。
使用方式
先判断用户所在平台:ricebowl.ai、sora2.cloud 或本地兼容 API。然后按以下顺序引导:
install -> recharge credits -> create API key -> set base_url -> set key -> config show -> models list --json -> run first image/video task
平台映射:
- ricebowl.ai -> https://ricebowl.ai
- sora2.cloud -> https://sora2.cloud
- local dev -> http://127.0.0.1:3000
默认需要讲清楚的 4 件事:
- 安装包名是 ai-media-generator
- 实际命令名是 ai-media
- 核心配置只有 base_url 和 api_key
- 环境变量 AI_MEDIA_BASE_URL / AI_MEDIA_API_KEY 会覆盖本地配置
核心命令:
ai-media config set-base-url <BASE_URL>
ai-media config set-key <KEY>
ai-media config show
ai-media models list
ai-media models list --json
ai-media image generate --model <MODEL> --prompt <PROMPT>
ai-media image get --task-id <TASK_ID>
ai-media video generate --model <MODEL> --prompt <PROMPT>
ai-media video get --task-id <TASK_ID>
ai-media task get --kind <image|video> --task-id <TASK_ID>
新用户引导示例:
ai-media config set-base-url https://ricebowl.ai
ai-media config set-key gm_xxx
ai-media config show
ai-media models list --json
如果使用 sora2.cloud,只需把 set-base-url 改为:
ai-media config set-base-url https://sora2.cloud
适用场景
- 首次接触该 CLI 的用户,需要最短安装命令、平台充值路径、生成 key 的位置、可直接复制的配置命令,以及一条图片或视频命令。
- 需要自动化或脚本集成的用户,可补充 models list --json、image/video/task get、--wait、--poll-interval 以及环境变量覆盖方式。
限制
参数全表、默认值、输出行为需参考 references/cli-commands.md;充值、生成 key、平台 onboarding 需参考 references/platform-onboarding.md。关于具体收费、价格、平台支持范围等细节,资料中暂未提供。