集成

ATP Agent Skills

ATP Agent Skills 是提供给 Codex、Claude Code 与其他支持 SKILL.md 的 agent 使用的公开操作手册。安装后，agent 会了解 ATP 的验证方式、统一模型名称、API payload、异步媒体任务与常见错误，不需要把上游 provider 的接口写进你的项目。

Skills 是接入之后的那一层，不是接入本身。先把 agent 指向 Gateway，再安装这些 Skills。

先接上你的 agent

Claude Code、Codex CLI 与其他 agent 的 base URL、key 与模型配置 — 另外还有三个需要特别处理的工具。

Skills 不会保存你的 API key

Skills 只有 Markdown 指引。atp- key 仍应放在环境变量或密钥管理服务，不要写入 SKILL.md、代码或 git。

一行安装

安装全部七个官方 Skills：

# Codex
curl -fsSL https://atptoken.ai/skills/install.sh | sh -s -- codex

# Claude Code
curl -fsSL https://atptoken.ai/skills/install.sh | sh -s -- claude

# Install for both
curl -fsSL https://atptoken.ai/skills/install.sh | sh -s -- both

安装器默认不覆盖现有文件。更新官方版本时可明确允许替换：

curl -fsSL https://atptoken.ai/skills/install.sh | ATP_SKILLS_FORCE=1 sh -s -- codex

如果你的安全规范不允许 pipe to shell，请先下载、检查再执行：

curl -fsSL https://atptoken.ai/skills/install.sh -o /tmp/install-atptoken-skills.sh
less /tmp/install-atptoken-skills.sh
sh /tmp/install-atptoken-skills.sh codex

Skills 内容

Skill	何时使用
`atptoken-gateway`	验证、模型发现、通用错误、文件与媒体路由
`atptoken-openai`	OpenAI-compatible chat 与 Responses-style 工作流
`atptoken-anthropic`	Anthropic Messages 格式与 Claude 工具
`atptoken-gemini`	Gemini 原生 `generateContent` 格式
`atptoken-image`	同步图像生成
`atptoken-video`	文生视频／图生视频、task 创建与轮询
`atptoken-audio`	TTS、语音与音频任务

直接下载：Gateway · OpenAI · Anthropic · Gemini · Image · Video · Audio。

机器可读的完整清单在 /skills/manifest.json。

验证安装

# Codex
find "${CODEX_HOME:-$HOME/.codex}/skills" -maxdepth 2 -name SKILL.md \
  -path "*/atptoken-*"

# Claude Code
find "${CLAUDE_HOME:-$HOME/.claude}/skills" -maxdepth 2 -name SKILL.md \
  -path "*/atptoken-*"

接着在 agent 中要求「使用 ATP 生成一张图片」或「用 ATP 创建 Wan 视频任务」。agent 应先使用同一把 project key 调用 GET https://api.atptoken.ai/v1/models，再选择该 project 已启用的模型 — 也就是把任何 coding agent 接入 ATP 讲的同一个第一步。如果 agent 跳过这一步、自己写死一个模型名，那就是需要纠正的行为。

模型权限仍由 project 控管

安装 Skill 不会自动启用模型，也不会绕过 allowed models。GET /v1/models 没有出现的模型不能使用；请先到 Console 的 Resources 调整 project 模型。

← 上一页Coding agents 下一页 →OpenAI SDK