全部 Skill/火山方舟

火山方舟 Skill

火山方舟（豆包、Seedream、Seedance，以及方舟上的 GLM / Kimi / DeepSeek / MiniMax）的接入说明书。重点是三套互不通用的入口：配错不会报错，只会从后付费余额扣钱。

已实测volcengine-arkark.cn-beijing.volces.comBearer API Key · 管控面 AK/SK大模型 API更新 2026-09-10
14份 reference
7个易错点
8处文档勘误
0/3场景显著
INSTALL · 安装

安装

选你用的 Agent，复制命令。

npx -y skills add fxp/skillify --skill volcengine-ark --agent claude-code --yes

装到项目的 .claude/skills/；加 -g 装到全局。装完需要你手动执行 /reload-plugins，这一步 Agent 代劳不了。

或者让 Agent 自己装

读 https://github.com/fxp/skillify/blob/main/skills/volcengine-ark/prompt.md 并照它执行
下载 volcengine-ark.skill 260 KB 源文件 ↗

装对了的标志：references/ 下有 14 份文档，里面 grep '<!-- Gap:' 能搜到 8 处。

TRY ASKING · 装好后可以这样问

装好后，可以这样问你的 Agent

每一条都是这份 Skill 覆盖、并用真实调用验证过的任务。点一下复制。

CAPABILITIES · 能力清单

14 类能力

每类能力对应一份 reference，Agent 按任务只打开需要的那份。

Agent Plan 订阅套餐

专属 Key、AFP 抵扣、可用模型、入口配置

references/agent-plan.md…/api/plan/v3 · …/api/plan

Coding Plan 编程套餐

方舟 Key 加小写 Model Name，仅限编程工具内

references/coding-plan.md…/api/coding/v3 · …/api/coding

编程工具配置

在 Claude Code / Codex / Cline / Cursor 里配置套餐

references/tools-setup.md

对话补全

流式、深度思考、Function Calling、结构化输出、上下文缓存

references/chat.md

Responses API

有状态的多轮对话

references/responses.md

多模态输入

图片、视频、文档、音频输入

references/multimodal-input.md

图片与视频生成

Seedream 图片生成、Seedance 视频生成

references/image-video.md

向量化与语音

文本与多模态向量化、TTS、ASR

references/embeddings-speech.md/embeddings · /embeddings/multimodal

批量推理与应用 Bot

批量推理任务、应用 Bot

references/batch-and-bot.md

内置工具

联网搜索、MCP、图像处理

references/tools.md

管控面 API

AK/SK 签名，套餐与用量查询

references/management-api.md

模型选择

上下文窗口、能否关闭思考

references/models.md

SDK 与兼容层

OpenAI / Anthropic SDK 与官方 SDK

references/sdk-and-compat.md

错误与限流

错误码、限流、重试

references/errors-and-limits.md
FACTS · 当前事实

当前事实

三个入口都在 https://ark.cn-beijing.volces.com 下，Base URL、Key、model 格式必须配套。配错不会报错，而是从后付费余额扣钱，或者套餐额度不生效。

标准 API（后付费）Coding PlanAgent Plan
Base URL…/api/v3…/api/coding/v3…/api/plan/v3
Key方舟 API Key同一把方舟 API KeyAgent Plan 专属 Key，与方舟 Key 不通用
model 格式带日期的 Model ID
doubao-seed-2-0-lite-260428		小写 Model Name
doubao-seed-2.0-lite		同 Coding Plan
计费按 token 后付费，需先开通模型套餐次数额度AFP 抵扣
官方限制任何程序调用仅限 AI 编程工具内同样不可用于 API 调用
GOTCHAS · 易错点

你的 Agent 可能记错的 7 件事

每一条都用真实调用验证过。

  1. 控制台列出的 Model Name: auto 不能直接填。传 "auto" 返回 404；要用 Auto 路由得填 ark-code-latest，再在控制台选 Auto。
  2. Plan 入口接受带日期的 Model ID，但会静默按 Name 路由。传 doubao-seed-2-0-lite-260428 返回 200，实际服务的是 -260215。确认版本只能读响应里的 model。
  3. Anthropic 入口把 claude-* 静默换成 doubao-seed-2-1-turbo，抵扣系数 2.5。Claude Code 忘设 ANTHROPIC_MODEL 不会报错，只会多烧一倍多的额度。
  4. 「向量化不支持 OpenAI API」是错的。Plan 入口的 /embeddings 可用，但纯文本也只能用 doubao-embedding-vision，doubao-embedding-text / -large 都是 404。
  5. 两个向量化端点的响应形状不同。/embeddings 返回数组、dimensions:1024 生效；/embeddings/multimodal 返回单个对象、维度固定 2048。
  6. kimi-k3 的 max_tokens 把思维链算进去。设成 64 时返回 finish_reason: "length" 和空答案，改用 max_completion_tokens 才正常。
  7. SDK 里没有 get_afp_usage() 这类方法。套餐、用量、限流类接口要走 UniversalApi(...).do_call(...)。
LATEST TEST · 最新测试结果

最新测试结果

3 个场景都没有达到统计显著：两个领先但样本不够，第三个是出题失误（题目里写明了模型名，两边都答对）。这份 Skill 目前的价值主要在实测校正过的内容本身。

场景考的是什么装了 Skill没装p
纯文本向量化只有 doubao-embedding-vision 能用，两个向量化端点的响应形状还不一样5/52/50.167
kimi-k3 短输出max_tokens 把思维链算进去，给小了答案为空5/53/50.444
Anthropic 入口锁定模型题目里已写明模型名，两边都答对（出题失误）4/55/51.000
合并14/1510/150.169

2026-09-07 · 执行 Agent GLM-5.3 · 数字是满分次数。两边都能联网查官方文档，唯一差别是有没有装这份 Skill；判分由脚本真实调用线上 API 决定，标准在开跑前固定；p 为 Fisher 精确检验（双尾），小于 0.05 记为显著。测试账号只有 Agent Plan，场景限于 Plan 入口能覆盖的能力。

这轮测试针对 2026-09-07 的版本。此后 09-10 只调整了 SKILL.md 的结构，references 没有改动，还没有重跑对照测试。

已验证：Agent Plan 入口，测试账号 Medium 档，约 45 次真实调用。未实测：标准后付费入口、Coding Plan 套餐内行为、语音 / 同传、管控面接口——这些部分在 references 里标注为「文档原文，未实测」。