はじめに
Xenodia の統一 LLM token API、メディア API、Agent、Credits、決済の使い方。
ひとつの API から、インテリジェンスへ。
Xenodia は開発者と Agent に統一 LLM token API を提供します。利用可能なモデルと公開 token 価格を比較し、ひとつの API からリクエストを送り、アカウントで利用量を確認できます。画像と動画の API も同じアカウントで利用できます。
このドキュメントでできること：
- OpenAI-compatible endpoint から主要な言語モデルを呼び出す。
- 現在利用できる text、image、video モデルを確認する。
- 非同期の画像・動画タスクを作成し、結果を取得する。
- Agent-readable な契約を持つ能力を発見して呼び出す。
- Owner と Agent のウォレットを紐付け、課金を制御する。
- 対応 Agent Runtime に Xenodia CLI と Skills を導入する。
コア概念
| Concept | Meaning |
|---|---|
| LLM tokens | モデルのテキスト入力と出力の利用量を測る単位です。アカウント残高ではありません。 |
| Credits | アカウントに入金し、対応するモデル、メディア、capability のリクエストの支払いに利用します。 |
| Model APIs | OpenAI-compatible text 呼び出しと、共通の image / video generation endpoint。 |
| Model discovery | GET /v1/models が現在の model ID、modality、公開 capability、価格、可用性を返します。 |
| Wallet-aware billing | Xenodia credential を使い、owner、Agent、または制御された fallback ルールで課金します。 |
| Task resource | 長時間の media / capability 処理は task_id、state、poll_url、標準化された result または error を返します。 |
公開入口
| Surface | Purpose |
|---|---|
https://www.xenodia.xyz | モデルカタログ、公開価格、アカウント、console。 |
https://docs.xenodia.xyz | 開発者ドキュメントと API reference。 |
https://api.xenodia.xyz | Runtime API。 |
開発を始める
Quickstart で最初のリクエストを実行し、server integration の前に Authentication を確認してください。モデル固有の実装前には Model Discovery を利用します。
OpenAI-compatible client の最短手順：
- base URL を
https://api.xenodia.xyzに設定する。 - Xenodia API key を Bearer token として使う。
/v1/modelsから現在有効で利用可能な model ID を選ぶ。- その model ID で
POST /v1/chat/completionsを送る。
Source of truth
Model ID、可用性、capability、API 価格は live API と生成済み reference を使用してください。現在の Credits 残高、決済方法、利用履歴はログイン後のアカウントで確認してください。変更可能な値をサンプルから本番コードへ固定しないでください。