集成

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 codex

Skills 内容

Skill何时使用
atptoken-gateway验证、模型发现、通用错误、文件与媒体路由
atptoken-openaiOpenAI-compatible chat 与 Responses-style 工作流
atptoken-anthropicAnthropic Messages 格式与 Claude 工具
atptoken-geminiGemini 原生 generateContent 格式
atptoken-image同步图像生成
atptoken-video文生视频/图生视频、task 创建与轮询
atptoken-audioTTS、语音与音频任务

直接下载: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 模型。