豆包 AI 工具包

要解决什么问题

在火山方舟（Ark）上接豆包、Seedream、Seedance 时，模型 ID、子命令参数和默认说话人分散在控制台文档与多个 CLI（coze-coding-ai、seedream）里。写脚本或让 Agent 代跑任务时，容易用错模型、漏配鉴权，或在文生图「简洁路径」与「4K 可控路径」之间选错入口。

本技能把按用户意图选命令的速查表、各模态的调用模板和环境变量约定整理成一份可检索的说明，而不是替代官方 SDK 安装文档。

核心能力与用法脉络

技能按模态组织，每条意图对应推荐命令与默认模型，例如：

• 文生图：coze-coding-ai image（默认 doubao-seedream-4-0）；需要 --size 4K 等细粒度控制时用 seedream generate
• 文生视频：coze-coding-ai video（默认 doubao-seedance-1-0-pro），并在表中区分 fast / pro / lite 文生视频与图生视频模型 ID
• 语音：TTS 用 coze-coding-ai tts（含小荷等 Speaker ID）；ASR 用 coze-coding-ai asr -f 本地文件（自动 base64 上传，fun-asr）
• 文本与检索：对话可指定 doubao-seed-1-8-251228 等；联网搜索用 search，通过 --type 区分 web / image；Embedding 用 embedding 并指定维度

鉴权优先级在技能里写清：ARK_API_KEY 环境变量适用于 seedream / coze-coding-ai；coze-coding-ai 也可用 -H "Authorization: Bearer …" 传参，便于一次性任务不落盘密钥。

适用边界与注意点

• 前提：需已安装 coze-coding-dev-sdk、seedream-ark 并完成方舟 API Key 配置；技能不描述安装步骤本身。
• 视频：coze-coding-ai video 为同步等待直到任务结束，自动化里要预留超时与重试策略。
• TTS：音频经 API 响应返回，技能说明中强调不必强行指定本地输出路径的误用方式。
• 安全：密钥只走环境变量或请求头，不要写进仓库脚本；图像默认模型支持 2K/4K，与电商主图等场景模板需对照表中模型 ID 使用。