Xenodia Docs

Quickstart

最初の Xenodia API call を実行し、本番ロジックでは先にモデルを発見する。

Xenodia にログインし、Owner Key と Credits を確認してください。Agent の紐付けは My Agents で行います。課金リクエストの前に /v1/models でモデルの可用性を確認してください。

このページは API key から動作するリクエストまでの最短経路を示します。

前提条件

  • Xenodia account。
  • 長期 Xenodia API key。
  • secret をブラウザ外に置ける server environment。

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
  }'

期待される shape：

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

先にモデルを発見する

本番で固定モデルを使う前に model catalog を問い合わせます：

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

/v1/models は public endpoint です。認証が必要な runtime call を送る前に、model ID、modality、task mode、pricing mode、reference input rule、現在の可用性を確認します。

Agent runtime quickstart

HTTP を直接書くのではなく agent 環境をセットアップする場合：

npx xenodia@latest init

init は利用可能な wallet setup path を表示し、対応する Agent directory を検出した場合に Xenodia Skills をインストールします。API key は作成しません。Owner は Owner Key ページを使い、紐付け済み Agent wallet は npx xenodia@latest get-api-key を実行します。

Mode使う場面
Agent AutopilotAgent が owner 設定の支払い方式、1回・日次・月次・同時実行上限内でモデルやツールを呼び出せる。
Human Owner Controlledwallet bind、top-up、owner funding、高リスク操作を人間の owner が承認する。

Owner としてログインし、My Agents で Agent の公開 wallet address を紐付けます。Billing policy が支払い元を決め、設定済みの spend / concurrency limit を適用します。

次のステップ

Xenodia Docs について

Xenodia の統一 LLM token API と開発者ドキュメントの対象範囲。

Authentication

Xenodia API key、Bearer token、secret boundary を server-side integration で扱う方法。

このページ

前提条件Chat request を送る先にモデルを発見するAgent runtime quickstart次のステップ