Tham chiếu API/Mô hình và bảng giá
Mô hình và bảng giá
Dùng các endpoint này để lấy những mô hình bạn có thể gọi ngay lúc này, kèm độ dài ngữ cảnh, khả năng và giá, thay vì tự duy trì bảng mô hình.
Các endpoint này là công khai: không cần khóa API, và chỉ trả về những mô hình bạn có thể gọi ngay lúc này. Hãy gửi yêu cầu đến host API, cùng base URL bạn dùng để gọi mô hình.
Trên trang nàyexpand_more
Danh sách mô hìnhlink
Danh sách mô hình tương thích OpenAI. Mặc định chỉ trả về mô hình văn bản, nên các client coi mỗi mục là một mô hình chat có thể dùng ngay.
/v1/modelscurl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'Tham số truy vấn
output_modalities- Tùy chọn. Lọc theo loại đầu ra: text, image, video, all, hoặc kết hợp phân tách bằng dấu phẩy như text,image. Mặc định là text. Giá trị không hợp lệ trả về 400 invalid_output_modalities.
Trường phản hồi
id- ID mô hình để gửi trong model.
owned_by- Nhà cung cấp chính của mô hình. Khi một mô hình có nhiều nhà cung cấp, danh sách đầy đủ nằm trong providers của danh mục giá.
name- Tên hiển thị.
context_length- Cửa sổ ngữ cảnh tính bằng token. Chỉ có ở mô hình văn bản.
max_completion_tokens- Số token đầu ra tối đa cho mỗi yêu cầu. Chỉ có ở mô hình văn bản.
architecture- input_modalities và output_modalities là các loại đầu vào và đầu ra mà mô hình hỗ trợ và là nguồn chính xác; modality là chuỗi hiển thị được tạo từ chúng.
pricing- Giá mô hình văn bản tính bằng USD trên mỗi token, dạng chuỗi thập phân. prompt là đầu vào, completion là đầu ra, còn input_cache_read, input_cache_write và input_cache_write_1h là đọc và ghi cache; các mục mô hình không hỗ trợ sẽ bị bỏ qua.
supported_parameters- Các khả năng đã được xác nhận mô hình hỗ trợ, như max_tokens và tools.
{
"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"]
}
]
}Ví dụ chỉ giữ lại một mô hình và lược bớt một số trường.
- /models và /v1/models trả về cùng nội dung.
- Phản hồi có kèm ETag. Gửi If-None-Match và nếu danh sách không đổi sẽ trả về 304, nên việc thăm dò định kỳ rất nhẹ.
- Mô hình tạm thời hết công suất vẫn nằm trong danh sách; các lệnh gọi đến nó trả về 429 cho đến khi có công suất trở lại.
Danh mục giálink
Giá của mọi mô hình bạn có thể gọi lúc này, theo cùng một định dạng cho văn bản, hình ảnh và video. Khác với danh sách mô hình, mặc định nó trả về mọi loại.
/v1/models/pricingcurl 'https://api.wokey.ai/v1/models/pricing?model=deepseek-v4.1-flash'
curl 'https://api.wokey.ai/v1/models/pricing?output_modalities=image,video'Tham số truy vấn
output_modalities- Tùy chọn. Cùng giá trị như danh sách mô hình; mặc định là all.
model- Tùy chọn. Trả về một mô hình, so khớp không phân biệt chữ hoa chữ thường. ID mô hình không tồn tại trả về danh sách rỗng.
Trường phản hồi
owned_by / providers- owned_by là nhà cung cấp chính; providers liệt kê các nhà cung cấp đang được bật theo thứ tự ưu tiên mặc định, dùng các ID nhà cung cấp mà tham số yêu cầu provider chấp nhận. Giá như nhau dù nhà cung cấp nào phục vụ yêu cầu.
pricing_skus- Danh sách các mục giá, cùng một cấu trúc cho mọi mô hình.
pricing_skus[].meter- Hạng mục được tính phí. Mô hình văn bản dùng input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cache_write_5m_tokens và cache_write_1h_tokens; hình ảnh dùng output_images; video dùng output_video.
pricing_skus[].unit / quantity- Đơn vị và số lượng được định giá: mỗi 1,000,000 token cho văn bản, mỗi ảnh, và mỗi giây video.
pricing_skus[].price_usd- Giá Wokey tính bằng USD, dạng chuỗi thập phân.
reference_price_usd / savings_pct- Chỉ có ở mô hình văn bản: giá tham chiếu chính thức và mức giảm so với giá đó, tính bằng phần trăm.
pricing_skus[].constraints- Điều kiện áp dụng giá, chẳng hạn bậc kích thước ảnh, hoặc chế độ, độ phân giải và khoảng thời lượng của video.
time_of_day- Chỉ dành cho mô hình định giá theo khung giờ. current_tier là khung giờ hiện tại (peak hoặc off_peak), peak_windows_utc liệt kê các giờ cao điểm theo UTC, và tiers cho biết giá của cả hai khung giờ. pricing_skus luôn hiển thị khung giờ hiện tại.
prompt_tiers- Chỉ dành cho mô hình định giá theo độ dài đầu vào. Khi đầu vào của yêu cầu (bao gồm đọc và ghi cache) vượt quá above_prompt_tokens, mọi hạng mục tính phí đều dùng giá của bậc đó.
{
"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"
}
]
}
]
}Ví dụ chỉ giữ lại một mô hình và lược bớt một số trường.
- Giá có thể thay đổi theo khung giờ và theo nguồn cung, nên endpoint này không bao giờ được cache và luôn trả về giá hiện tại.
Mô hình hình ảnh và videolink
curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'/v1/images/modelsTrả về các mô hình hình ảnh bạn có thể gọi lúc này: các endpoint được hỗ trợ (tạo, chỉnh sửa), tham số và giá trị cho phép (parameter_schema), khả năng hỗ trợ streaming và chỉnh sửa, và giá mỗi ảnh (pricing_skus). Cách dùng: Tạo hình ảnh →
/v1/videos/modelsTrả về các mô hình video có ít nhất một biến thể có thể bán: chế độ tạo, độ phân giải, tỷ lệ khung hình, khoảng thời lượng, giới hạn tham chiếu đa phương thức, và giá mỗi giây của từng biến thể (pricing_skus). Cách dùng: Tạo video →