| name | arkcli-infer-endpoint |
| version | 1.3.0 |
| description | arkcli 推理接入点**管理**能力：对**已有** Endpoint 做获取、列表、启动、停止、删除、更新（生命周期管理 + 启停 + 销毁）。优先使用产品命令 `arkcli infer endpoint ...`，而不是直接调用 Raw API。**反触发（重要）：用户说『创建/新建/create/部署/deploy 一个 endpoint/接入点』这类新建接入点的意图，一律走 arkcli-deploy（`+deploy`），不要用本 skill 的 `infer endpoint create`**；本 skill 的 `create` 仅用于脚本化 / CI / 需要无护栏的可预测 raw CRUD 行为（不做复用检查、不渲染示例）、且明确要绕过 +deploy 工作流护栏的场景。TTS/ASR/语音模型连 raw create 也不要引导，只能转 models search 说明 arkcli 不支持 Endpoint 创建。 |
| metadata | {"requires":{"bins":["arkcli"]},"cliHelp":"arkcli infer endpoint --help"} |
arkcli infer endpoint
CRITICAL — 开始前 MUST 先读取 ../arkcli-shared/SKILL.md。
使用原则
- 推理接入点相关需求优先使用
arkcli infer endpoint ...
- 这些命令虽然是标准 CLI 类型，但实现入口仍然来自
shortcuts/inferendpoint/
- 只有产品命令无法覆盖时，才回退到
../arkcli-api-explorer/SKILL.md
infer endpoint create 成功后会返回 Endpoint Id- 这个
Id 应作为后续 get / start / stop 的输入，也可以传给 ../arkcli-code-example/SKILL.md 生成带真实 endpoint-id 的调用示例
- 如果已经通过
infer endpoint create 拿到 Id，不要再调用 +deploy 试图"二次部署"；+deploy 本身就是创建 Endpoint 的工作流
infer endpoint create --billing-method 当前只支持 token；它是可选项，显式传 token 时会先校验模型是否支持 token 推理方式，创建请求本身保持默认行为- 语音模型不是 Endpoint create 目标：TTS / ASR / 配音 / 播客 / 音色 / 实时语音交互，或模型名命中
doubao-seed-tts-*、doubao-seed-asr-*、seedasr-* 时，不要用 infer endpoint create 或 Raw CRUD 绕过；只转 arkcli-models 说明"广场可搜，但当前 arkcli 不支持 Endpoint 创建"。
「我的接入点」语义
用户说**"我的推理接入点 / 我创建的 / 我有多少个 / 列出我的"** → 必须加 --mine --page-all：
arkcli infer endpoint list --mine --page-all --page-size 100 --format json
服务端按 sys:ark:createdBy tag 过滤，只返回当前 SSO sub-user 创建的 endpoint。
需要 SSO 子账号登录；root 账号 / AK-SK 直接报错（引导重登）。
详细行为见 references/arkcli-infer-endpoint-list.md。
infer endpoint create 与 +deploy 的边界
infer endpoint create 是原始 CRUD，适合脚本化 / CI / 需要无护栏可预测行为的场景。注意它的 flag 集其实是 +deploy 的子集（+deploy 才是参数超集），差别在"有没有工作流护栏"，不是"谁参数更多"。它不包含 +deploy 的以下护栏：
| 护栏 | +deploy | infer endpoint create |
|---|
| 实名前置校验（realname-gate.md） | ✅ | ✅（foundation model 路径同样触发 EnsureModelAvailable，含实名拦截） |
| 自定义模型复用检查（避免重复计费） | ✅ | ❌ |
部署后 profile 默认资源同步（--set-default） | ✅ | ❌ |
路由判定：只要用户意图是"创建 / 新建 / create 一个 endpoint / 接入点"或"把模型部署 / 上线"（无论用词是 create 还是 deploy），一律路由到 +deploy（arkcli-deploy）；只有用户明确需要绕过工作流护栏、脚本化 / CI、或要无护栏的可预测 raw CRUD 行为时，才使用 infer endpoint create。
例外：如果目标是语音模型（TTS / ASR / 播客 / 音色 / 实时语音交互），不要因为用户说了"create endpoint"就进入本 skill；语音模型在 arkcli 当前只支持 models search 发现，不支持 Endpoint 创建。
命令一览
| 命令 | 说明 |
|---|
arkcli infer endpoint create | 创建推理接入点（原始 CRUD，无部署工作流护栏）；新建接入点的默认意图请用 +deploy，此命令仅限脚本化 / 无护栏 raw CRUD 场景 |
arkcli infer endpoint get <endpoint-id> | 获取推理接入点详情 |
arkcli infer endpoint list [--mine] | 列出推理接入点；用户说**"我的 / 我自己的 / 我创建的 / 我有多少"**时必须加 --mine（SSO sub-user 过滤） |
arkcli infer endpoint start <endpoint-id> | 启动推理接入点 |
arkcli infer endpoint stop <endpoint-id> | 停止推理接入点 |
arkcli infer endpoint delete <endpoint-id> | 删除推理接入点（不可逆，需二次确认；非交互环境需 ARKCLI_ALLOW_HEADLESS_DELETE=1，--yes 不授权） |
arkcli infer endpoint update <endpoint-id> | 更新推理接入点（名称 / 描述 / 限流） |
参考
