集成
ATP Agent Skills
ATP Agent Skills 是提供给 Codex、Claude Code 与其他支持 SKILL.md 的 agent 使用的公开操作手册。安装后,agent 会了解 ATP 的验证方式、统一模型名称、API payload、异步媒体任务与常见错误,不需要把上游 provider 的接口写进你的项目。
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 codexSkills 内容
| 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 已启用的模型。
模型权限仍由 project 控管
安装 Skill 不会自动启用模型,也不会绕过 allowed models。GET /v1/models 没有出现的模型不能使用;请先到 Console 的 Resources 调整 project 模型。