SuperAPI AI 工具集

ai-media-cli

通用与其它

查看项目

更新于 10-15 07:49

技能介绍

用途

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 件事:

  1. 安装包名是 ai-media-generator
  2. 实际命令名是 ai-media
  3. 核心配置只有 base_url 和 api_key
  4. 环境变量 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。关于具体收费、价格、平台支持范围等细节,资料中暂未提供。