Agent Skill 安装与使用
从官网安全直装到 Codex、Claude Code、OpenClaw 或项目目录，用自己的密钥完成模型工作流。
更新日期
开始之前
- Python 3.10+；支持本地技能的 Agent；自己创建的 LINK42 API Key。
选择工具并安装
打开 Skill 页面
选择 Codex、Claude Code、OpenClaw 或项目目录，复制校验过的安装命令；国内和国际使用同一官网包。
确认安装目录
Codex：~/.agents/skills/link42-api；Claude Code：~/.claude/skills/link42-api；OpenClaw：~/.openclaw/skills/link42-api；项目：.agents/skills/link42-api。安装不改全局配置；更新保留备份。
配置私密环境变量
在运行 Agent 的安全环境设置 LINK42_API_KEY，并重新加载技能。不要把密钥放在提示词、URL、命令参数或项目提交里。
先发现、再估价、最后执行
Skill 以当前 Key 的 /v1/models 授权目录为准，结合公开参数；同名有歧义时保留版本并确认，不把 V4.1 和 V4 混为一个。调用前选择支持的分辨率、比例、时长和输入模式。
CLI 生成操作必须显式 --execute。估价不是最终扣费上限；需要硬性上限时同时在 Key 设置预算。异步请求保存 task_id 与 idempotency_key；超时只恢复原任务，不能反复创建收费任务。
python3 scripts/link42_agent.py discover
python3 scripts/link42_agent.py estimate --json quote.json
python3 scripts/link42_agent.py image-create --json image.json --execute --max-estimate-usd 0.10
python3 scripts/link42_agent.py image-wait --id TASK_ID支持范围与故障恢复
除逐项调用外，doctor 可以验证授权目录，plan 会解析模型并校验已知参数再估价，workflow-plan 可对 1–8 个明确步骤合计估价。规划不自动创建任务，也不伪造下一步素材；多轮对话、函数调用结果和参考图工作流详见安装包里的 workflows.md 与 request-examples.md。
| 能力 | 可用操作 | 边界 |
|---|---|---|
| Text / Vision | chat, responses, messages, count-tokens, gemini, embeddings | 模型支持决定工具、思考和输入类型。 |
| Image | image, image-edit, image-create/get/wait | 参考图编辑是 JSON，不是 multipart。 |
| Video | video-create/get/list/wait/cancel | 支持的角色与参数来自当前模型；取消需明确请求。 |
| Assets / Usage | asset-upload/list/get/delete/complete, usage-report/logs/csv, score | 只访问本人资源，用量需 Key 开启读取。 |
- 不支持 Audio、Realtime、Batch 和托管 Agent 功能。Skill 不授予管理权限；ClawHub / SkillHub 尚未发布。失败保留脱敏 code、request_id、task_id，不输出密钥。