Flatkey CLI

给媒体团队和 AI Agent 用的 Flatkey 命令行工具。一个 CLI 调用图片、视频、语音、音效、音乐和文本生成，共用同一套 Flatkey credits。

语言：English | 简体中文 | 日本語

官网：flatkey.ai

安装

npm install -g @flatkey-ai/cli

查看本地版本：

flatkey --version
flatkey -v

鉴权

推荐用浏览器登录：

flatkey login

flatkey login 会打开 Flatkey 控制台授权页，授权成功后把 CLI API key 和账号信息保存到本地配置。登录后可以检查当前生效的鉴权状态：

flatkey auth status
flatkey status --json

如果终端不能自动打开浏览器，可以只打印授权链接，手动复制打开：

flatkey login --no-open

退出登录并移除本地保存的 API key：

flatkey logout

也可以用环境变量：

export FLATKEY_API_KEY=<your-flatkey-api-key>

或手动创建 key 后保存到本地配置：

flatkey onboard --api-key <key>

快速开始

flatkey image generate --prompt "editorial cover, neon city at dawn" -o cover.png
flatkey video generate --prompt "cinematic product launch clip" --model seedance2 -o launch.mp4
flatkey audio generate --prompt "你好，这是 Flatkey 的配音测试" -o speech.mp3
flatkey models --json
flatkey credits --json

常用命令

生成图片

flatkey image generate \
  --prompt "magazine cover, reflective typography, studio lighting" \
  --model gpt-image-2 \
  -o cover.png

生成视频

flatkey video generate \
  --prompt "8 second cinematic product reveal, glossy black background" \
  --model seedance2 \
  -o launch.mp4

生成语音

flatkey audio generate \
  --prompt "你好，这是 Flatkey 网关的语音测试。" \
  --voice-id EXAVITQu4vr4xnSDxMaL \
  --model eleven_multilingual_v2 \
  --stability 0.5 \
  --similarity-boost 0.75 \
  --style 0 \
  -o speech.mp3

查询音色

flatkey audio voices --json

生成音效

flatkey audio sfx \
  --prompt "glass shattering on the floor" \
  --duration 3 \
  -o sfx.mp3

生成音乐

flatkey audio music \
  --prompt "calm ambient piano, sad mood" \
  --music-length-ms 10000 \
  -o music.mp3

生成文本

flatkey text generate \
  --prompt "write 5 sharp headlines for a creator tool launch" \
  --model gpt-5.5 \
  -o headlines.txt

Credits、状态、模型

flatkey credits --json
flatkey status --json
flatkey models --json
flatkey models --type image --json
flatkey help --ai

给 AI Agent 的最短说明

把这段直接给 AI：

你可以用 Flatkey CLI 做媒体生成。

安装：npm install -g @flatkey-ai/cli
鉴权：优先运行 flatkey login；也可以使用环境变量 FLATKEY_API_KEY。

规则：
1. 需要机器可读输出时，命令加 --json。
2. 需要本地文件时，必须加 --output 或 -o。
3. 不确定模型时，先跑 flatkey models --json。
4. 做 TTS 前，先跑 flatkey audio voices --json 拿 voice_id。
5. 看请求但不烧钱，用 --dry-run --json。

路由

• 生成路由：https://router.flatkey.ai
• 模型列表：https://console.flatkey.ai/v1/available_models
• 音色列表：https://router.flatkey.ai/v1/voices

链接

• 官网：flatkey.ai
• npm：@flatkey-ai/cli
• Issues：github.com/flatkey-ai/flatkey-cli/issues