Tài liệu API Hop
Danh mục mô hình
Liệt kê mô hình khả dụng cho khóa API hiện tại và giao thức công khai của chúng.
https://api.apihop.ai/v1/modelsGET https://api.apihop.ai/v1/models trả về mô hình khả dụng cho khóa API hiện tại. Khả dụng có thể thay đổi theo cấu hình mô hình, tình trạng dịch vụ và quyền khóa API, nên phản hồi API trực tiếp là nguồn sự thật cuối cùng.
Claude Sonnet 4.6 (claude-sonnet-4-6) được nhà cung cấp thượng nguồn hỗ trợ nhưng hiện chưa công bố trên API Hop. Đây không phải mặc định tích hợp đang hoạt động. Trước khi gọi bất kỳ mô hình nào, xác nhận quyền truy cập bằng phản hồi GET https://api.apihop.ai/v1/models của chính bạn.
GET https://api.apihop.ai/v1/modelsXác thực
Mọi yêu cầu cần Bearer Token.
Authorization: Bearer YOUR_API_KEYVí dụ yêu cầu
curl --request GET \
--url https://api.apihop.ai/v1/models \
--header 'Authorization: Bearer YOUR_API_KEY'Phản hồi
uidstringMã định danh mô hình công khai. Với API nhận model, dùng giá trị này trong trường model của thân yêu cầu.
namestringTên hiển thị.
versionstring | nullTrường phiên bản. Mục hiện tại thường trả null.
typestringLoại mô hình, hiện chủ yếu là text, image hoặc video.
pricingobject | nullGiá nền tảng hiện tại của mô hình. Dùng API trực tiếp hoặc bảng điều khiển để biết giá trị hiện tại.
Ví dụ thành công
{
"success": true,
"data": [
{
"uid": "gpt-5.6-sol",
"name": "ChatGPT-5.6 Sol",
"version": null,
"type": "text",
"pricing": {
"unit": "credits",
"tokenTierBasis": "input_tokens",
"tiers": []
}
},
{
"uid": "seedance-2.5",
"name": "Seedance 2.5",
"version": null,
"type": "video",
"pricing": {
"unit": "credits",
"tiers": []
}
}
],
"requestId": "req_..."
}Mô hình văn bản hiện tại
Bảng sau tóm tắt mô hình văn bản hiện được ghi trong tài liệu. Với mỗi yêu cầu, dùng mô hình trả về từ lời gọi GET https://api.apihop.ai/v1/models của bạn.
| Dòng mô hình | ID mô hình | Chat Completions | Responses | Claude Messages |
|---|---|---|---|---|
| OpenAI | gpt-5.4 | Có | Có | - |
| OpenAI | gpt-5.5 | Có | Có | - |
| OpenAI | gpt-5.6-sol | Có | Có | - |
| OpenAI | gpt-5.6-terra | Có | Có | - |
| OpenAI | gpt-6-astra | Có | Có | - |
| Anthropic | claude-fable-5 | Có | - | Có |
| Anthropic | claude-fable-5-1 | Có | - | Có |
| Anthropic | claude-opus-4-6 | Có | - | Có |
| Anthropic | claude-opus-4-7 | Có | - | Có |
| Anthropic | claude-opus-4-8 | Có | - | Có |
| Anthropic | claude-opus-5 | Có | - | Có |
| Anthropic | claude-opus-5-5 | Có | - | Có |
| Anthropic | claude-sonnet-5 | Có | - | Có |
| Anthropic | claude-sonnet-5-5 | Có | - | Có |
| DeepSeek | deepseek-v4-flash | Có | - | - |
| DeepSeek | deepseek-v4-pro | Có | - | - |
| DeepSeek | deepseek-v4.1-flash | Sau triển khai và bật | - | - |
| Gemini | gemini-3.6-flash | Có | - | - |
| Gemini | gemini-3.7-flash | Có | - | - |
| Gemini | gemini-3.8-flash | Có | - | - |
| Gemini | gemini-3.5-flash-lite | Có | - | - |
| Gemini | gemini-4-argon | Có (sau khi bật) | - | - |
| Kimi | kimi-k3 | Có | - | - |
| MiniMax | minimax-m3 | Có | - | - |
Ngân sách đầu ra Claude gồm suy nghĩ và văn bản cuối. Giá trị max_tokens nhỏ như 128 có thể hết trước khi tạo bất kỳ văn bản cuối nào. Dùng ngân sách số nguyên dương đủ chỗ cho cả hai, như mô tả trong Claude Messages.
Hướng dẫn dòng mô hình
- Mô hình DeepSeek:
deepseek-v4-flash,deepseek-v4-pro,deepseek-v4.1-flash(ID riêng, chỉ khả dụng sau triển khai và bật; kiểm traGET https://api.apihop.ai/v1/models) - Mô hình Gemini:
gemini-3.6-flash,gemini-3.7-flash,gemini-3.8-flash,gemini-3.5-flash-lite,gemini-4-argon(sau triển khai và bật) - Mô hình Kimi:
kimi-k3 - Mô hình MiniMax:
minimax-m3
Các hướng dẫn bao gồm chọn mô hình, ví dụ yêu cầu, lưu ý ngân sách đầu ra và giới hạn giao thức công khai hiện tại. Phản hồi trực tiếp từ điểm cuối này vẫn có thẩm quyền quyết định khả dụng.
Mô hình ảnh và video hiện tại
| Dòng mô hình | ID mô hình | Loại | Điểm cuối công khai |
|---|---|---|---|
| OpenAI | gpt-image-2 | Ảnh | POST https://api.apihop.ai/openai/v1/images/generations |
| OpenAI | gpt-image-2.5-flare | Ảnh | POST https://api.apihop.ai/openai/v1/images/generations |
| OpenAI | gpt-image-2.5-sunburst | Ảnh | POST https://api.apihop.ai/openai/v1/images/generations |
| BytePlus | seedance-2.0 | Video | POST https://api.apihop.ai/v1/video/seedance |
| BytePlus | seedance-2.5 | Video | POST https://api.apihop.ai/v1/video/seedance |
Điểm vào API khác
twitterapi đại diện API dữ liệu Twitter, không phải mô hình Chat. Dùng điểm cuối /v1/twitter/* thay vì truyền twitterapi vào Chat Completions.
Quy tắc ID mô hình
- API Chat Completions, Responses, Claude Messages, ảnh và video Seedance
dùng model.
- ID mô hình Seedance chuẩn là
seedance-2.0vàseedance-2.5. Điểm cuối Seedance 2.0 cũng nhận bí danh cũseedance-2-0, nhưng yêu cầu mới và tra cứu danh mục nên dùng ID chuẩn có dấu chấm. - Chỉ dùng ID mô hình do
GET https://api.apihop.ai/v1/modelstrả về. - Mô hình không khả dụng không xuất hiện trong
/v1/modelsvà không nên dùng cho lời gọi mới. - Khóa API có hạn chế mô hình có thể nhận tập con của mô hình trong tài liệu.
Tài liệu liên quan
- Chat Completions chung
- Mô hình DeepSeek
- Mô hình Gemini
- Mô hình Kimi
- Mô hình MiniMax
- OpenAI Responses
- Claude Messages
- Tạo ảnh GPT-Image-2
- Tạo video Seedance 2.0
- Tạo video Seedance 2.5
Phản hồi lỗi
Xem Mã lỗi và khắc phục để có tham chiếu mã đầy đủ, khác biệt giao thức và bước chẩn đoán.
{
"success": false,
"error": {
"code": 20000,
"message": "Invalid or missing API key"
},
"requestId": "req_..."
}