Mô hình Gemini

Mô hình Gemini dùng điểm cuối Hoàn thành hội thoại chung. Trang này ghi lại giá trị model được hỗ trợ và hợp đồng hội thoại văn bản.

POST https://api.apihop.ai/v1/chat-completions

Mô hình khả dụng

gemini-4-argon cần triển khai và bật. Việc xuất hiện trong tham chiếu này không xác nhận khả dụng trên môi trường sản xuất.

Tên mô hình phân biệt cấp sản phẩm; chúng không phải SLA độ trễ, thông lượng hay chất lượng. So sánh mô hình bằng khối lượng công việc thực tế. Kiểm tra GET https://api.apihop.ai/v1/models để biết khả dụng với khóa API trước khi yêu cầu.

Xác thực

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Yêu cầu không truyền luồng

{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}

Yêu cầu truyền luồng

{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}

Điểm cuối này mặc định trả một phản hồi JSON hoàn chỉnh. Đặt rõ stream: true khi cần truyền luồng SSE.

Trường yêu cầu

Xem Hoàn thành hội thoại chung để biết các trường dùng chung như temperature, top_p, frequency_penalty, presence_penalty, stop và n. Hỗ trợ và hành vi của trường tùy chọn phụ thuộc mô hình được chọn; trang này không bảo đảm mọi trường dùng chung.

Phản hồi thành công

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}

usage có thể gồm chi tiết token suy luận tùy chọn; máy khách cần chấp nhận việc chúng vắng mặt hoặc thay đổi theo mô hình.

Lưu ý sử dụng

• model trong thân yêu cầu phải là một ID mô hình công khai trong bảng Mô hình khả dụng.
• Tên sản phẩm, tên hiển thị và bí danh khác không được chấp nhận thay cho ID mô hình công khai.
• Trang này chỉ áp dụng cho yêu cầu Chat Completions gửi đến POST https://api.apihop.ai/v1/chat-completions, không phải OpenAI Responses hoặc Claude Messages.
• Dùng GET https://api.apihop.ai/v1/models để biết mô hình hiển thị với khóa API hiện tại, và dùng bảng điều khiển để xem giá hiện hành.

Tài liệu liên quan

• Hoàn thành hội thoại chung
• Danh mục mô hình