Model Discovery API

发现 Xenodia public models、modalities、pricing hints、async support 和 capability metadata。

发送模型专属请求前，先使用 GET /v1/models。模型目录可以避免客户端猜测当前启用的模型、参数和可用状态。

这个 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",
      "tiers": [
        { "id": "1k", "label": "1K", "unit": "image", "price_micro_usdc": 18750 },
        { "id": "2k", "label": "2K", "unit": "image", "price_micro_usdc": 62500 },
        { "id": "4k", "label": "4K", "unit": "image", "price_micro_usdc": 100000 }
      ]
    },
    "reference_input": {
      "supported": true,
      "transport": ["url", "multipart_file"],
      "max_items": 16
    }
  },
  "enabled": true,
  "available": true
}

需要读取的字段

Field	Why it matters
`id`	请求中传入的 public model ID。
`name`	Xenodia 目录中的模型展示名称。
`owned_by`, `brand_key`, `brand_image_url`	Xenodia 目录中的模型品牌信息。
`modalities`	模型支持 text、image、video、audio 或 mixed input。
`channel_names`	当前可用于该模型的公开 Xenodia 路由标签。
`price_input_per_m`, `price_output_per_m`	文本模型 token price 字段，或 media entry 的展示字段。
`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 和数量限制。

Response 还包含 top-level payment object，提供 minimum / recommended top-up hints。

Client rule

不要从模型名字推断 media support。读取 modalities 和 capabilities。

只使用 enabled 和 available 均为 true 的条目。价格和可用性可能变化，价格敏感界面应在展示前重新读取模型目录。

文档示例用于说明请求格式，不是永久型号清单。请使用当前目录中的 ID，不要直接照抄旧书签或历史示例。新版图片示例使用 GPT Image 2.5；所有媒体请求统一返回异步任务。

视频创建近期受到明确拒绝时，available 可能在冷却期内变为 false：限流为一分钟，接口不可用为十五分钟。较新的已接受请求可恢复可用状态。可用状态仅是调用前提示，不保证任务完成，仍需查询任务终态。