介绍
Xenodia 是什么、网关如何工作，以及接入公共 API 时应该从哪里开始。
Xenodia 是面向 agentic systems 的统一 AI 网关。它把模型访问、路由、媒体生成、钱包感知计费和 agent 设置合并到一个公共集成面。
使用这份文档可以完成：
- 通过 Xenodia 调用 OpenAI-compatible chat models。
- 在写死模型 ID 之前发现可用的文本、图片和视频模型。
- 发起同步或异步图片生成。
- 创建异步 Veo3.1 或 Seedance 2.0 视频任务。
- 通过标准化的 task resource 轮询媒体结果。
- 为 owner wallet 和 agent wallet 绑定受控计费关系。
- 为支持的 agent runtime 安装 Xenodia CLI 和 skill instructions。
适合谁阅读
- 需要统一 text / media gateway 的产品后端。
- 需要 API key、wallet boundary 和 model discovery 的 agent platform，例如 OpenClaw。
- 需要稳定 action layer 的 Skill、MCP 和 marketplace 构建者。
核心概念
| 概念 | 含义 |
|---|---|
| Model Aggregation API | OpenAI-compatible text endpoint，加上共享的 image / video generation endpoint。 |
| Model Discovery | GET /v1/models 返回启用中的模型 ID、模态、capability、价格提示和可用 channel。 |
| Unified key and payment | Runtime call 使用 Xenodia API key，计费由 owner、agent 或受控 fallback wallet 规则决定。 |
| Task resource | 长任务返回 task_id、state、poll_url 和标准化的 result / error 字段。 |
| Skill Marketplace layer | Skill 应只携带轻量设置说明，并链接回 docs 获取完整 API 信息。 |
公共入口
| Surface | Purpose |
|---|---|
https://www.xenodia.xyz | 官网、价格、模型页面、账号和 console 入口。 |
https://docs.xenodia.xyz | 开发者文档和 API reference。 |
https://api.xenodia.xyz | Runtime API endpoint。 |
阅读顺序
如果想先跑通一次请求，从 快速开始 开始。服务端接入前先看 认证。上线模型相关逻辑前，先使用 模型发现。
OpenAI-compatible client 的最短路径：
- 把 base URL 改成
https://api.xenodia.xyz。 - 使用 Xenodia API key 作为 Bearer token。
- 查询
/v1/models选择当前启用的模型 ID。 - 使用支持的模型 ID 调用
POST /v1/chat/completions。
Source of truth
docs frontend 是独立项目，但不应该变成第二个后端。Endpoint schema、模型可用性、价格和 capability data 应来自现有 Xenodia backend、OpenAPI 和导出的 model catalog snapshot。