API Hop

Tài liệu

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.

GEThttps://api.apihop.ai/v1/models

GET 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.

text
GET https://api.apihop.ai/v1/models

Xác thực

Mọi yêu cầu cần Bearer Token.

http
Authorization: Bearer YOUR_API_KEY

Ví dụ yêu cầu

bash
curl --request GET \
  --url https://api.apihop.ai/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'

Phản hồi

uidstring

Mã đị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.

namestring

Tên hiển thị.

versionstring | null

Trường phiên bản. Mục hiện tại thường trả null.

typestring

Loại mô hình, hiện chủ yếu là text, image hoặc video.

pricingobject | null

Giá 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

json
{
  "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ìnhID mô hìnhChat CompletionsResponsesClaude Messages
OpenAIgpt-5.4CóCó-
OpenAIgpt-5.5CóCó-
OpenAIgpt-5.6-solCóCó-
OpenAIgpt-5.6-terraCóCó-
OpenAIgpt-6-astraCóCó-
Anthropicclaude-fable-5Có-Có
Anthropicclaude-fable-5-1Có-Có
Anthropicclaude-opus-4-6Có-Có
Anthropicclaude-opus-4-7Có-Có
Anthropicclaude-opus-4-8Có-Có
Anthropicclaude-opus-5Có-Có
Anthropicclaude-opus-5-5Có-Có
Anthropicclaude-sonnet-5Có-Có
Anthropicclaude-sonnet-5-5Có-Có
DeepSeekdeepseek-v4-flashCó--
DeepSeekdeepseek-v4-proCó--
DeepSeekdeepseek-v4.1-flashSau triển khai và bật--
Geminigemini-3.6-flashCó--
Geminigemini-3.7-flashCó--
Geminigemini-3.8-flashCó--
Geminigemini-3.5-flash-liteCó--
Geminigemini-4-argonCó (sau khi bật)--
Kimikimi-k3Có--
MiniMaxminimax-m3Có--

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 tra GET 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ìnhID mô hìnhLoạiĐiểm cuối công khai
OpenAIgpt-image-2ẢnhPOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-flareẢnhPOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-sunburstẢnhPOST https://api.apihop.ai/openai/v1/images/generations
BytePlusseedance-2.0VideoPOST https://api.apihop.ai/v1/video/seedance
BytePlusseedance-2.5VideoPOST 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.0 và 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/models trả về.
  • Mô hình không khả dụng không xuất hiện trong /v1/models và 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.

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.

json
{
  "success": false,
  "error": {
    "code": 20000,
    "message": "Invalid or missing API key"
  },
  "requestId": "req_..."
}