ai-media-cli

ai-media CLI

Use this skill to handle these requests:

• Install ai-media-generator
• Configure ai-media CLI
• Connect to ricebowl.ai or sora2.cloud
• Explain command parameters, common usage, scripted calls
• Onboard new users, including topping up, generating keys, writing configuration

Quick Start

First determine which platform the user is on:

• ricebowl.ai
• sora2.cloud
• Local compatible API

Then walk the user through in this order:

install
  -> recharge credits
  -> create API key
  -> set base_url
  -> set key
  -> config show
  -> models list --json
  -> run first image/video task

Platform Mapping

• ricebowl.ai -> https://ricebowl.ai
• sora2.cloud -> https://sora2.cloud
• local dev -> http://127.0.0.1:3000

What To Explain By Default

By default, make these 4 things clear:

1. The package name is ai-media-generator
2. The actual command name is ai-media
3. The core configuration is only base_url and api_key
4. The environment variable AI_MEDIA_BASE_URL / AI_MEDIA_API_KEY will override the local configuration

Core Commands

Common commands:

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>

When To Load References

• Full parameter table, default values, output behavior: read references/cli-commands.md
• Topping up, generating keys, platform onboarding: read references/platform-onboarding.md

Response Pattern

If the user is new to this CLI, prioritize giving:

1. The shortest installation command
2. The platform top-up path
3. The location for generating a key
4. A set of configuration commands that can be copied directly
5. One image command or video command

If the user wants automation or script integration, add:

• models list --json
• image/video/task get
• --wait
• --poll-interval
• How to override with environment variables

Friendly Onboarding Snippet

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

If it is sora2.cloud, just change set-base-url to:

ai-media config set-base-url https://sora2.cloud