Coze CLI 技能

Coze CLI 是字节跳动 Coze 平台的命令行工具，提供图片生成、音频生成、视频生成、聊天对话、工作流执行等功能。

基础认证

安装依赖

# 验证node和npm版本
node -v
npm -v
# 如果未安装nodejs，需先安装nodejs，参考不同操作系统调整

# 使用npm安装
npm install -g @coze/cli

#验证安装成功
coze --version

登录认证

# 推荐：浏览器OAuth登录
coze auth login --oauth

# 检查登录状态
coze auth status

# 登出
coze auth logout

可以使用个人凭证登录

# 申请定制 https://www.coze.cn/open/oauth/pats
# 添加环境变量 COZE_API_TOKEN
export COZE_API_TOKEN=pat_xxxxtoken

组织和工作空间管理

# 列出所有可访问的组织
coze organization list
coze org list

# 设置默认组织
coze organization use <org_id>
coze org use <org_id>

# 切换到个人账号
coze organization use

# 列出所有可用工作空间
coze space list

# 设置默认工作空间
coze space use <space_id>

图片生成 (generate image)

基础用法

# 生成图片（默认带水印）
coze generate image "A cat"

# 生成无水印图片
coze generate image "A cat" --no-watermark

常用参数

保存到文件

# 保存到指定路径
coze generate image "A cat" --no-watermark --output-path ./cat.png

# 保存到目录（会自动生成文件名）
coze generate image "A sunset" --no-watermark --output-path ./

注意: --output-path 参数会自动创建目录，文件名格式为 image_YYYYMMDD_HHMMSS_N.jpeg

音频生成 (generate audio)

# 文字转语音
coze generate audio "Hello world"

# 保存到文件
coze generate audio "你好，世界" --output-path ./hello.mp3

视频生成 (generate video)

# 生成视频
coze generate video create "A dancing dog"

# 保存到文件
coze generate video create "A cat playing piano" --output-path ./piano_cat.mp4

聊天对话 (chat)

# 与Bot对话
coze chat <bot_id> "你好"

# 使用工作流
coze chat <workflow_id> "我的问题"

工作流执行 (workflow)

# 运行工作流
coze workflow run <workflow_id> --input '{"key": "value"}'

全局选项

常见错误

查看帮助

# 查看主帮助
coze --help

# 查看子命令帮助
coze generate --help
coze generate image --help
coze auth --help
coze organization --help
coze space --help