はじめに
Xenodia とは何か、ゲートウェイがどのように動くか、公共 API の導入をどこから始めるか。
Xenodia は agentic systems のための統一 AI ゲートウェイです。モデルアクセス、ルーティング、メディア生成、ウォレット連動の課金、agent セットアップを 1 つの公共インテグレーション面にまとめます。
このドキュメントでできること：
- Xenodia 経由で OpenAI-compatible chat models を呼び出す。
- モデル ID を固定する前に、利用可能な text、image、video モデルを確認する。
- 同期または非同期の画像生成を実行する。
- Veo3.1 または Seedance 2.0 の非同期 video task を作成する。
- 標準化された task resource でメディア結果を polling する。
- owner wallet と agent wallet をバインドし、制御された課金境界を作る。
- 対応 agent runtime に Xenodia CLI と skill instructions を導入する。
対象読者
- text / media gateway を 1 つにまとめたいプロダクト backend。
- API key、wallet boundary、model discovery を必要とする agent platform、たとえば OpenClaw。
- 安定した action layer を必要とする Skill、MCP、marketplace ビルダー。
コア概念
| Concept | Meaning |
|---|---|
| Model Aggregation API | OpenAI-compatible text endpoint と共有 image / video generation endpoint。 |
| Model Discovery | GET /v1/models が有効な model ID、modality、capability、価格ヒント、利用可能 channel を返します。 |
| Unified key and payment | Runtime call は Xenodia API key を使い、課金は owner、agent、または制御された fallback wallet rule で解決されます。 |
| Task resource | 長時間処理は task_id、state、poll_url、標準化された result / error を返します。 |
| Skill Marketplace layer | Skill は軽量なセットアップ情報を持ち、完全な API 情報は docs にリンクします。 |
公開 surface
| Surface | Purpose |
|---|---|
https://www.xenodia.xyz | Web サイト、価格、モデルページ、アカウントと console 入口。 |
https://docs.xenodia.xyz | 開発者ドキュメントと API reference。 |
https://api.xenodia.xyz | Runtime API endpoint。 |
読み方
まず動くリクエストを作るなら Quickstart から始めます。サーバー統合の前に 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
docs frontend は独立していますが、第二の backend にはしません。Endpoint schema、モデル可用性、価格、capability data は既存 Xenodia backend、OpenAPI、export された model catalog snapshot から同期します。