Model Discovery API

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

model-specific request を送る前に GET /v1/models を使います。Catalog により、現在有効な model、parameter、channel を 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": "nano-banana-pro",
  "object": "model",
  "name": "nano-banana-pro",
  "owned_by": "kie",
  "brand_key": "kie",
  "brand_image_url": "/v1/models/brands/kie/image",
  "upstream_id": "google/nano-banana-pro",
  "released_at": null,
  "modalities": ["image"],
  "description": "Image generation and editing model.",
  "price_input_per_m": 0,
  "price_output_per_m": 0,
  "capabilities": {
    "async_supported": true,
    "request_mode": ["sync", "task"],
    "pricing": {
      "mode": "resolution"
    },
    "reference_input": {
      "supported": true,
      "transport": ["url", "multipart_file"],
      "max_items": 8
    }
  },
  "enabled": true,
  "available_channels": []
}

読むべき fields

Field	Why it matters
`id`	request に渡す public model ID。
`name`	public または upstream model ID から作られる表示名。
`owned_by`, `brand_key`, `brand_image_url`	provider / brand metadata。
`upstream_id`	Xenodia public ID と異なる場合の provider-facing model ID。
`modalities`	text、image、video、audio、mixed input の対応。
`price_input_per_m`, `price_output_per_m`	text model の token price field、または media entry の表示 field。
`capabilities.async_supported`	task mode を使えるか。
`capabilities.request_mode`	sync、task、または両方。
`capabilities.pricing`	media pricing mode と tier。
`capabilities.parameters`	request controls と enum。
`capabilities.reference_input`	reference input transport と item limit。
`available_channels`	現在その model を提供できる active channel。

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

Client rule

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

価格表示 UI では、zero-price tier を「この snapshot では未価格設定」と扱います。video price tier が設定されていない場合、runtime call は拒否されることがあります。