volcengine arkcli +code-example
前置条件： 先阅读
../arkcli-shared/SKILL.md了解认证、全局参数和安全规则。
为指定基础模型生成多语言 SDK 调用示例代码，同时写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。
什么时候用
- 用户说"生成示例代码 / SDK 示例 / curl 命令 / 怎么调用这个模型"，且已经知道模型名
- 想把某个基础模型的多语言调用模板保存到本地
反路由（不要用本命令）：
- 只是想试模型效果 →
../arkcli-chat/SKILL.md（文本/多模态对话）或../arkcli-gen/SKILL.md（出图/视频） - 还不知道模型名 → 先
../arkcli-models/SKILL.mdmodels search/get - 需要先创建接入点 →
../arkcli-deploy/SKILL.md - 语音模型（TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互，或
doubao-seed-tts-*/doubao-seed-asr-*/seedasr-*）→ 不使用+code-example。models search能搜到不代表 OpenGetSampleCode 有示例；不要把后端ModelVersion required理解成"补一个版本就能生成"，应说明当前 arkcli 不支持语音模型示例代码。
快速开始
# 拿某基础模型的全部语言示例（写入 ./ark-examples/<model>/）
arkcli +code-example --model doubao-seedream-5-0
# 指定版本 + 只看 Python + 结构化输出
arkcli +code-example --model doubao-seedream-5-0 --version 260128 --language python --format json
--model必填，可传基础模型名或合并 ID（doubao-seedream-5-0-260128）--version可选；不传时 CLI 自动推导（合并 ID 拆版本 → 找ArkModels匹配 → GetFoundationModel 取PrimaryVersion兜底），全都拿不到才报错要求显式传--version- 内部机制：接口约束
ModelVersion必填，缺失时 CLI 走上述回退链自动补齐；custom model 走 PrimaryVersion 兜底时 scenario 自动切finetune_inference，foundation model 无论显式版本或 PrimaryVersion 兜底一律保持quick_access --language可选：python/go/java/node/curl（shell是curl别名），默认全部--output-dir可选，默认./ark-examples/<model>--format json输出结构化条目（含language/io_type/install/code）- 语音模型没有 arkcli 示例代码路径；命中 TTS / ASR / 语音交互时停在
arkcli models search <keyword>的发现说明，不要继续调用本命令
0.1.17 变更：旧版
--endpoint-id已移除——新数据源按基础模型取码，不再支持按已有接入点 ID 取码。如需指向某 endpoint，生成后把代码里的model="..."手动改成你的ep-xxx。
命令一览
| 命令 | 说明 |
|---|---|
arkcli +code-example --model <name> [--version <ver>] [--language <lang>] [--output-dir <dir>] [--format json] |
生成多语言示例代码并写入本地 |
输出形态
- 本地文件：按"IO 任务类型"分子目录（对齐后端
IOType维度），同类型下按语言分文件；带安装步骤的语言把安装命令写进文件头注释。 - 结构化 JSON：
--format json时给出按(语言 × IO 类型)展开的条目。 - 人类可读：默认按后端顺序打印各代码块。
详细参数、目录结构示例、常见链路与 FAQ 见 references/arkcli-code-example.md。
参考
- references/arkcli-code-example.md — 完整命令手册
- arkcli-models / arkcli-deploy / arkcli-infer-endpoint / arkcli-shared