API 參考/模型與價格查詢
模型與價格查詢
用這幾個端點取得目前可呼叫的模型，以及其上下文長度、支援能力與價格，不必手動維護模型表。
這些端點是公開的：不需要 API 金鑰，而且只回傳你目前可以呼叫的模型。請將請求送到 API 主機，也就是模型呼叫所用的同一個 base URL。
模型列表link
與 OpenAI 相容的模型列表。預設只回傳文字模型，因此把每個項目都當成聊天模型的用戶端可以直接使用。
GET
/v1/modelscURL
curl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'查詢參數
output_modalities- 選填。依輸出類型篩選：text、image、video、all，或以逗號分隔的組合，例如 text,image。預設為 text。無效的值會回傳 400 invalid_output_modalities。
回應欄位
id- 作為 model 傳送的模型 ID。
owned_by- 模型的主要供應商。一個模型有多家供應商時，完整列表在價格目錄的 providers 中。
name- 顯示名稱。
context_length- 以 token 計的上下文視窗。僅限文字模型。
max_completion_tokens- 每個請求的最大輸出 token 數。僅限文字模型。
architecture- input_modalities 和 output_modalities 是模型支援的輸入與輸出類型，以此為準；modality 是由它們組成的顯示字串。
pricing- 文字模型的價格，以每 token 的 USD 計，格式為十進位字串。prompt 是輸入，completion 是輸出，input_cache_read、input_cache_write 和 input_cache_write_1h 是快取讀取與寫入；模型不支援的項目會省略。
supported_parameters- 已確認模型支援的功能，例如 max_tokens 和 tools。
JSON
{
"object": "list",
"data": [
{
"id": "deepseek-v4.1-flash",
"owned_by": "deepseek",
"object": "model",
"created": 0,
"name": "DeepSeek-V4.1-Flash",
"context_length": 1000000,
"max_completion_tokens": 393216,
"architecture": {
"modality": "text+image->text",
"input_modalities": ["text", "image"],
"output_modalities": ["text"]
},
"pricing": {
"prompt": "0.000000075",
"completion": "0.0000003",
"input_cache_read": "0.0000000015"
},
"supported_parameters": ["max_tokens", "tools"]
}
]
}範例只保留一個模型，並省略了部分欄位。
- /models 和 /v1/models 回傳相同的內容。
- 回應會帶有 ETag。傳送 If-None-Match 時，若列表沒有變化會回傳 304，因此輪詢的成本很低。
- 暫時滿載的模型仍會留在列表中；在容量釋出之前，呼叫該模型會回傳 429。
價格目錄link
你目前可以呼叫的所有模型的價格，文字、圖片和影片使用同一種格式。與模型列表不同，預設回傳所有類型。
GET
/v1/models/pricingcURL
curl 'https://api.wokey.ai/v1/models/pricing?model=deepseek-v4.1-flash'
curl 'https://api.wokey.ai/v1/models/pricing?output_modalities=image,video'查詢參數
output_modalities- 選填。值與模型列表相同；預設為 all。
model- 選填。只回傳一個模型，比對時不分大小寫。未知的模型 ID 會回傳空列表。
回應欄位
owned_by / providers- owned_by 是主要供應商；providers 依預設優先順序列出目前啟用的供應商，使用 provider 請求參數接受的供應商 ID。無論由哪家供應商處理請求，價格都相同。
pricing_skus- 價格項目列表，所有模型的格式都相同。
pricing_skus[].meter- 計費項目。文字模型使用 input_tokens、output_tokens、cache_read_tokens、cache_write_tokens、cache_write_5m_tokens 和 cache_write_1h_tokens；圖片使用 output_images；影片使用 output_video。
pricing_skus[].unit / quantity- 計價的單位與數量：文字為每 1,000,000 個 token，圖片為每張，影片為每秒。
pricing_skus[].price_usd- 以 USD 計的 Wokey 價格，格式為十進位字串。
reference_price_usd / savings_pct- 僅限文字模型：官方參考價格，以及相對於它的折扣百分比。
pricing_skus[].constraints- 價格適用的條件，例如圖片尺寸級距，或影片的模式、解析度與時長範圍。
time_of_day- 僅適用於依時段計價的模型。current_tier 是目前的時段（peak 或 off_peak），peak_windows_utc 以 UTC 列出尖峰時段，tiers 提供兩個時段的價格。pricing_skus 一律顯示目前時段的價格。
prompt_tiers- 僅適用於依輸入長度計價的模型。請求的輸入（含快取讀取與寫入）超過 above_prompt_tokens 時，所有計費項目都使用該級距的價格。
JSON
{
"object": "list",
"data": [
{
"id": "deepseek-v4.1-flash",
"name": "DeepSeek-V4.1-Flash",
"owned_by": "deepseek",
"providers": ["deepseek", "opencode", "ollama", "volcengine"],
"object": "model",
"available": true,
"currency": "USD",
"pricing_skus": [
{
"sku_id": "deepseek-v4.1-flash:input_tokens",
"meter": "input_tokens",
"unit": "token",
"quantity": 1000000,
"price_usd": "0.075000",
"reference_price_usd": "0.150000",
"savings_pct": "50"
},
{
"sku_id": "deepseek-v4.1-flash:output_tokens",
"meter": "output_tokens",
"unit": "token",
"quantity": 1000000,
"price_usd": "0.300000",
"reference_price_usd": "0.600000",
"savings_pct": "50"
}
]
}
]
}範例只保留一個模型，並省略了部分欄位。
- 價格可能隨時段和供應情況變動，因此這個端點從不快取，一律回傳目前的價格。
圖片與影片模型link
cURL
curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'