| name | adapt-custom-endpoint |
| description | 当用户要求把采用 JSON 提交后轮询协议的视频供应商接入 ArcReel，或要求编写、验证、测试、保存自定义调用端点定义时使用。 |
适配自定义调用端点
使用随 skill 提供的 scripts/custom_endpoint.py 调用 ArcReel HTTP API；共享 validator 和 API 是验证与保存定义的唯一入口。
工作流
- 读取用户提供的供应商文档 URL；无法读取时请用户粘贴提交、查询任务与响应示例。
确认协议属于 JSON 请求/响应的「提交后轮询」形态。签名鉴权、multipart 请求或按素材切换路由
无法由首期定义表达，直接说明缺口。
- 需要编写或修正定义时读取定义格式，在工作目录创建定义 JSON、
测试参数 JSON，以及供应商提供的真实响应样本。凭证优先引用 ArcReel 已保存的自定义供应商
provider_id；不得把 API Key 写入项目文件、命令参数或回复。
- 运行当前 skill 目录下的
scripts/custom_endpoint.py，用 validate <definition.json> 子命令校验。
修正到 errors 为空。schema_version.level 非 direct 或仍有 warnings 时，修正或向用户说明接受的原因和影响；用 hints 准备测试所需的接口地址和模型。
- 对供应商的提交与轮询响应分别运行
check-response；定义包含 result 时也检查取件响应。
- 运行
preview-request，核对 URL、method、打码后的 headers、body 与素材摘要。定义有必需素材时，
用 --start-image / --end-image / --reference-images / --reference-audio-files 附上对应文件。
- 测试连接会真实请求供应商并可能计费。调用前必须回问用户。 获得明确同意后才运行
trial-run ... --confirm-cost（沿用预览时的素材参数），再用 trial-status <run-id> 查询到终态，
并转述请求、响应、取值与错误。状态为 succeeded 时继续；其他终态停止，只有用户明确要求保存未验证定义时才继续。
- 再次 validate。没有同血统端点时用
save 新建；有重复时默认另存副本并告知用户。
只有覆盖既有端点必须回问用户；明确同意后才用
save ... --endpoint-id <id> --confirm-overwrite。保存成功以返回 ce-<id> 为完成判据。
连接
在当前工作区根目录运行脚本。脚本读取 setup-arcreel-skills 创建的 .arcreel/settings.json，从
mcp_url 派生同实例的 /api/v1 地址，并用 api_key 鉴权；配置缺失或无效时先执行 setup skill，
不回退到 localhost。
设置 ARCREEL_EMBEDDED_AGENT=1 时，脚本优先使用 ARCREEL_API_BASE 与 ARCREEL_API_TOKEN；该 JWT
有效期 15 分钟且不续期，API 调用返回 401 时告知用户重开会话获取新 token。
AUTH_ENABLED=false 的本地部署可留空 token。
