介绍
开发者如何使用 Xenodia 的统一 LLM token API、媒体 API、Agent、Credits 与支付能力。
智能，通过一个 API 获取。
Xenodia 为开发者和 Agent 提供统一的 LLM token API。比较可用模型与公开 token 价格，通过一个 API 发起请求，并在账户中查看用量。图像与视频 API 使用同一个账户。
这份文档可以帮助你：
- 通过 OpenAI-compatible endpoint 调用主流语言模型。
- 在选择模型 ID 前，发现当前可用的文本、图片和视频模型。
- 创建异步图片与视频任务，并查询结果。
- 发现和调用带 Agent 可读契约的能力。
- 绑定主账户和 Agent 钱包，并设置受控计费。
- 为支持的 Agent Runtime 安装 Xenodia CLI 与 Skills。
适合谁阅读
- 需要统一接入文本与媒体模型的产品后端。
- 需要 API key、钱包边界和实时模型目录的 Agent 平台。
- 需要稳定计费与能力调用层的 Skill 和 MCP 开发者。
核心概念
| 概念 | 含义 |
|---|---|
| LLM tokens | 模型输入与输出文本的计量单位，用于统计用量，不是账户余额。 |
| Credits | 为账户充值，并用于支付支持的模型、媒体和能力请求。 |
| Model APIs | OpenAI-compatible 文本调用，以及共享的图片和视频生成 endpoint。 |
| Model discovery | GET /v1/models 返回当前模型 ID、模态、公开能力、价格和可用状态。 |
| Capabilities | GET /v1/capabilities 返回 Agent 可调用的工具、操作、价格、可用状态和说明。 |
| Wallet-aware billing | Runtime 使用 Xenodia 凭证；计费可按主账户、Agent 或受控 fallback 规则结算。 |
| Task resource | 长时间运行的媒体与能力调用返回 task_id、state、poll_url 以及标准化 result 或 error。 |
公共入口
| 入口 | 用途 |
|---|---|
https://www.xenodia.xyz | 模型目录、公开价格、账户和控制台。 |
https://docs.xenodia.xyz | 开发者文档与 API reference。 |
https://api.xenodia.xyz | Runtime API。 |
开始接入
需要先跑通请求时，从快速开始开始。服务端接入前阅读认证。上线模型相关功能前使用模型发现。Agent 需要发现和调用工具时使用能力。
OpenAI-compatible 客户端的最短路径：
- 将 base URL 设为
https://api.xenodia.xyz。 - 使用 Xenodia API key 作为 Bearer token。
- 查询
/v1/models，选择当前已启用且可用的模型 ID。 - 使用该模型 ID 调用
POST /v1/chat/completions。
信息来源
模型 ID、可用性、能力和 API 价格以实时 API 与生成的 reference 为准。当前 Credits 余额、支付方式和用量记录以登录后的账户页面为准。不要把示例中的可变数据复制为生产常量。