Models

GET /v1/models

列出所有啟用的 AI 模型，含定價資訊。不需要特定權限，只需有效的 API Key。

請求

GET /v1/models
Authorization: Bearer sk-your-api-key

查詢參數

參數	類型	說明
type	string	篩選模型類型：chat、embedding、rerank
owned_by	string	篩選提供商：openai、anthropic、google、baai 等
model_id	string	指定模型 ID，回傳符合的模型

三個參數可組合使用。沒有符合條件的模型時，data 回傳空陣列。

回應

{
  "success": true,
  "code": 1000,
  "message": "Success",
  "data": [
    {
      "type": "chat",
      "owned_by": "openai",
      "model_id": "openai/gpt-4o",
      "model_name": "GPT-4o",
      "context_length": 128000,
      "max_output_tokens": 16384,
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"],
      "input_price_per_1m": 2.5,
      "output_price_per_1m": 10.0,
      "available": true
    },
    {
      "type": "embedding",
      "owned_by": "openai",
      "model_id": "openai/text-embedding-3-small",
      "model_name": "Text Embedding 3 Small",
      "dimensions": 1536,
      "context_length": 8191,
      "input_price_per_1m": 0.02,
      "output_price_per_1m": 0,
      "supports_batch": true,
      "available": true
    },
    {
      "type": "rerank",
      "owned_by": "baai",
      "model_id": "baai/bge-reranker-v2-m3",
      "model_name": "BGE Reranker v2 M3",
      "max_documents": 100,
      "max_tokens_per_doc": 4096,
      "supports_truncate": true,
      "supports_raw_scores": true,
      "price_per_search": 0.00005,
      "available": true
    }
  ]
}

通用欄位

欄位	類型	說明
type	string	chat / embedding / rerank
owned_by	string	模型提供商
model_id	string	模型 ID，格式為 provider/model-name
model_name	string	人類可讀的模型名稱
available	boolean	是否當前可用

Chat 模型專屬欄位

欄位	類型	說明
context_length	number	最大 Context 長度（Token 數）
max_output_tokens	number	最大輸出 Token 數
input_modalities	string[]	支援的輸入模態（text、image 等）
output_modalities	string[]	支援的輸出模態
input_price_per_1m	number	輸入定價，USD / 1M tokens（上游原始費率，不含 markup）
output_price_per_1m	number	輸出定價，USD / 1M tokens（上游原始費率，不含 markup）

Embedding 模型專屬欄位

欄位	類型	說明
dimensions	number	向量維度
context_length	number	最大輸入長度（Token 數）
input_price_per_1m	number	輸入定價，USD / 1M tokens
supports_batch	boolean	是否支援批次輸入

Rerank 模型專屬欄位

欄位	類型	說明
max_documents	number	單次最多可排序的文件數
max_tokens_per_doc	number	每份文件的 Token 上限
supports_truncate	boolean	超過 Token 上限時是否自動截斷
supports_raw_scores	boolean	是否支援回傳原始分數
price_per_search	number	每次搜尋的定價（USD）

範例請求

# 只列出 Chat 模型
GET /v1/models?type=chat

# 只列出 OpenAI 的模型
GET /v1/models?owned_by=openai

# 查詢特定模型
GET /v1/models?model_id=openai/gpt-4o

# 組合篩選
GET /v1/models?type=embedding&owned_by=baai