Coze Coding CLI

解决什么问题

在本地脚本、终端或自动化流程中调用 Coze Coding 的多媒体与模型能力时，直接拼 HTTP 接口通常要处理三类容易出错的细节：个人访问令牌、项目上下文和请求响应结构。coze cli 面向这些场景，把 coze-coding-ai 背后的集成 API 包装成命令行能力，使图片生成、视频生成、语音合成、语音识别、联网搜索、LLM 对话和 Embedding 可以在本地目录中完成，而不是把鉴权头、项目 ID 和接口参数散落在业务代码里。

核心能力与工作方式

• 模型与媒体能力：基于 Coze Coding integration API，覆盖 Seedream 图片生成、视频生成、语音合成/识别、联网搜索、对话式 LLM 调用和 Embedding。
• 鉴权机制：优先使用 pat_ 开头的访问令牌，可通过 COZE_API_TOKEN 或 .env 提供；SDK 也会尝试读取本地运行时配置中的 token。
• 项目上下文：integration 接口通常要求请求携带 project_id，常见方式是在运行目录维护 .coze 文件，并确保 project_id 带引号；也可以在使用 -H 时显式传入项目头。
• 排错边界：缺少项目上下文或 PAT 权限不足时，接口可能返回 403；token 无效或过期会表现为 401 或 invalid token。coze auth status 的登录态只影响 coze code * 系列命令，不直接决定该 CLI 是否可用。

适用场景

适合把 Coze Coding 的媒体生成、检索、对话和向量化能力嵌入本地工作流、原型验证或批处理脚本。若目标是多租户服务、复杂权限管理或高并发网关，仍需要在外层补齐限流、审计、密钥轮换和服务端鉴权策略。