Xenodia Docs

快速开始

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

先在 Xenodia 登录，打开 Owner Key 获取密钥，并检查 Credits。需要连接 Agent 钱包时，在 My Agents 绑定它的公开地址。发送计费请求前，先查询 /v1/models，确认所选模型当前可用。

这页展示从 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": "gpt-6-astra",
    "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 是公开接口。用它选择模型 ID、支持的模态、任务模式、计价方式、参考输入规则和当前可用状态，再发起需要认证的调用。

Agent runtime quickstart

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

npx xenodia@latest init

init 会显示可用的钱包设置路径，并在发现支持的 Agent 目录时安装 Xenodia Skills。它不会创建 API key。主账户在 Owner Key 页面获取密钥；已绑定的 Agent 钱包可以运行 npx xenodia@latest get-api-key。

Mode适用场景
Agent AutopilotAgent 可在 owner 配置的付款方式、单次、每日、每月和并发限制内调用模型与工具。
Human Owner Controlled钱包绑定、充值、owner 代付或高风险动作需要人类 owner 批准。

主账户登录后，在 My Agents 中绑定 Agent 的公开钱包地址。计费策略决定谁付费，并执行已配置的消费和并发限制。

下一步

关于 Xenodia Docs

Xenodia 统一 LLM token API 和开发者文档的范围。

认证

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

本页内容

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