Model Discovery API

Xenodia public models、modalities、pricing hints、async support、capability metadata を発見する。

model-specific request を送る前に GET /v1/models を使います。Catalog により、現在有効な model、parameter、availability を client が推測せずに済みます。

この endpoint は public です。API key がない段階でも呼び出し、選んだ model ID を認証済み runtime request に使えます。

Endpoint

GET https://api.xenodia.xyz/v1/models

cURL

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

Example model item

{
  "id": "gpt-image-2.5-flare",
  "object": "model",
  "name": "gpt-image-2.5-flare",
  "owned_by": "OpenAI",
  "brand_key": "openai",
  "brand_image_url": "",
  "released_at": null,
  "modalities": ["image"],
  "channel_names": ["Image Route 12"],
  "description": "GPT Image 2.5 Flare image generation and editing. Pricing is based on resolution.",
  "price_input_per_m": 18750,
  "price_output_per_m": 18750,
  "capabilities": {
    "async_supported": true,
    "request_mode": ["task"],
    "pricing": {
      "mode": "resolution"
    },
    "reference_input": {
      "supported": true,
      "transport": ["url", "multipart_file"],
      "max_items": 16
    }
  },
  "enabled": true,
  "available": true
}

読むべき fields

Field	Why it matters
`id`	request に渡す public model ID。
`name`	Xenodia カタログで表示されるモデル名。
`owned_by`, `brand_key`, `brand_image_url`	Xenodia カタログのモデルブランド情報。
`modalities`	text、image、video、audio、mixed input の対応。
`channel_names`	このモデルで現在利用できる公開 Xenodia route label。
`price_input_per_m`, `price_output_per_m`	text model の token price field、または media entry の表示 field。
`capabilities.async_supported`	task resource が返るか。画像・動画生成は現在 task mode 必須です。
`capabilities.request_mode`	Supported request mode. Media generation uses `task`.
`capabilities.pricing`	media pricing mode と tier。
`capabilities.parameters`	request controls と enum。
`capabilities.reference_input`	reference input transport と item limit。

Response には top-level payment object も含まれ、minimum / recommended top-up hints を返します。

Client rule

model name から media support を推測しないでください。modalities と capabilities を読んでください。

enabled と available がどちらも true の entry だけを使用してください。価格や可用性は変わるため、価格表示 UI は表示前に catalog を再取得します。