API 参考/模型与价格查询
模型与价格查询
用这几个接口在程序里获取当前能调用的模型、上下文长度、支持的能力和价格，不用手动维护模型表。
这几个接口都是公开的，不需要 API Key，只返回当前能调用的模型。请求发到 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- 模型 ID，调用时填在 model 里。
owned_by- 模型的主供应商。同一个模型有多家供应商时，完整列表见价格目录的 providers。
name- 显示名称。
context_length- 上下文窗口，单位 token。只有文本模型有。
max_completion_tokens- 单次最多输出的 token 数。只有文本模型有。
architecture- input_modalities 和 output_modalities 是模型支持的输入、输出类型，以这两个数组为准；modality 是由它们拼出来的展示文字。
pricing- 文本模型的价格，单位是美元 / 每个 token，十进制字符串。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- 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'