Xenodia Docs

快速开始

发起第一次 Xenodia API 调用，并在生产逻辑中先发现模型。

这页展示从 API key 到可工作的请求的最短路径。

前置条件

  • 一个 Xenodia account。
  • 一个长期 Xenodia API key。
  • 一个能把 secret 留在服务端的运行环境。

设置 key：

export XENODIA_API_KEY="YOUR_LONG_TERM_KEY"

发送 chat request

curl -X POST "https://api.xenodia.xyz/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XENODIA_API_KEY" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "You are a precise test assistant." },
      { "role": "user", "content": "Reply with OK only." }
    ],
    "temperature": 0
  }'

返回结构：

{
  "id": "chatcmpl-xxx",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "OK"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 1,
    "total_tokens": 19
  }
}

先发现模型

上线前先查询模型目录：

curl "https://api.xenodia.xyz/v1/models"

/v1/models 是 public endpoint。用它选择模型 ID、模态、async support、pricing mode、reference input rules 和 available channels，再发起需要认证的 runtime call。

Agent runtime quickstart

如果是在设置 agent 环境，而不是手写 HTTP：

npx xenodia@latest init

这个流程应检测 wallet readiness、安装 Xenodia skill instructions、帮助定位或配置 API key，并把 agent 指回这份文档获取完整 endpoint 信息。

Mode适用场景
Agent AutopilotAgent 可在 owner 定义的 spend 和 channel boundary 内调用模型和工具。
Human Owner Controlled钱包绑定、top-up、channel access 或高风险动作需要人类 owner 批准。

钱包感知 agent 应先绑定 owner，再创建或分配 agent identity。Owner boundary 决定谁付费，以及 agent 可以使用哪些模型或 channel。

下一步

关于 Xenodia Docs

Xenodia 统一模型、钱包、Skill 和 action-layer 文档的产品背景。

认证

如何在服务端集成里处理 Xenodia API key、Bearer token 和 secret boundary。

本页内容

前置条件发送 chat request先发现模型Agent runtime quickstart下一步