• file：音频文件路径（支持格式：mp3、wav、m4a、webm、mp4）
• --language：ISO 639-1 语言代码（例如 "en"、"ja"、"zh"）

输出（JSON 格式，打印至 stdout）：

{ "text": "Transcribed content here...", "language": "en", "duration": 12.5 }

2. 文本转语音（TTS）

将文本转换为语音音频。当用户需要从文本生成语音或音频时使用。

python scripts/router9.py tts  -o 
 [--voice ] [--format ]

• text：待合成的文本（最长 4096 字符）
• -o：输出文件路径（必需）
• --voice：语音 ID（默认值："alloy"）
• --format：音频格式，可选 "mp3"（默认）、"wav"、"opus"

输出：将音频文件写入 -o 指定路径。

3. 图像描述

以自然语言描述图像内容。当用户需要分析、描述或理解图像内容时使用。

python scripts/router9.py describe  [--prompt ]

• file：图像文件路径（支持格式：jpg、png、webp、gif）
• --prompt：关于该图像的具体问题

输出（JSON 格式，打印至 stdout）：

{ "description": "A golden retriever sitting on a park bench..." }

4. OCR（文本提取）

从图像中提取文本——包括印刷体、手写体、标识牌和标签等。当用户需要从图像或文档扫描件中读取文字时使用。

python scripts/router9.py ocr 

• file：图像文件路径（支持格式：jpg、png、webp、gif）

输出（JSON 格式，打印至 stdout）：

{ "fullText": "Invoice #1234nTotal: $150.00", "blocks": [...] }

5. 图像生成

根据文本提示生成图像。当用户要求创建、生成或绘制图像时使用。

python scripts/router9.py generate  -o 

• prompt：用于描述待生成图像的文本
• -o：输出文件路径（必需）

输出：将生成的图像保存至 -o 指定路径。

6. 文件上传（存储）

使用预签名 URL（直传至 S3）将本地文件上传至 agent 存储。

python scripts/router9.py upload 

• file：待上传的本地文件路径（最大 50 MB）

输出（JSON 格式，打印至 stdout）：

{ "id": "file-abc123", "filename": "report.pdf", "sizeBytes": 204800 }

7. 文件下载（存储）

根据文件 ID 从 agent 存储中下载文件。

python scripts/router9.py download  [-o 
]

• file_id：上传或列表操作返回的文件 ID
• -o：输出文件路径（默认为原始文件名）

输出（JSON 格式，打印至 stdout）：

{ "status": "ok", "file": "report.pdf" }

8. 列出文件（存储）

列出 agent 存储中的所有文件。

python scripts/router9.py list [--page ] [--limit ]

• --page：页码（默认：1）
• --limit：每页条目数（默认：50）

输出（JSON 格式，打印至 stdout）：

{ "data": [{ "id": "file-abc123", "filename": "report.pdf", ... }], "pagination": { ... } }

9. 删除文件（存储）

从 agent 存储中删除指定文件。

python scripts/router9.py delete 

• file_id：待删除文件的 ID

输出（JSON 格式，打印至 stdout）：

{ "status": "ok", "message": "File deleted." }

10. 存储用量

查看当前存储用量及配额限制。

python scripts/router9.py usage

输出（JSON 格式，打印至 stdout）：

{ "usedBytes": 1073741824, "limitBytes": 5368709120, "usedFormatted": "1.0 GB", "limitFormatted": "5.0 GB" }

配额说明

用量按计费周期计量，各项技能拥有独立配额。 可在 Router9 控制台的 /settings/skills 页面查看剩余配额。