API Grok 4.5

Tài liệu tham khảo API đầy đủ cho các mô hình LLM Grok 4.5 do xAI cung cấp.

Các biến thể mô hình

API này hỗ trợ hai biến thể mô hình Grok 4.5:

So sánh nhanh

Grok 4.5 Text to Text

Điểm cuối API

httpSao chép
POST /api/v1/chat/completions

Tham số yêu cầu

Bắt buộc

Hỗ trợ tin nhắn

Tùy chọn

Yêu cầu mẫu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'grok-4.5-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Explain the key differences between REST and GraphQL APIs.'
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Grok 4.5 Image to Text

Điểm cuối API

httpSao chép
POST /api/v1/chat/completions

Tham số yêu cầu

Bắt buộc

Hỗ trợ tin nhắn

Tùy chọn

Yêu cầu mẫu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'grok-4.5-image-to-text',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'Describe the image and extract any visible text.' },
          {
            type: 'image_url',
            image_url: {
              url: 'https://example.com/sample-image.jpg'
            }
          }
        ]
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Định dạng phản hồi

Các mô hình LLM Grok 4.5 trả về phản hồi hoàn thành tương thích với OpenAI. Với stream: true, phản hồi sử dụng Server-Sent Events; với stream: false, phản hồi là một đối tượng JSON duy nhất.

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

textSao chép
data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"grok-4.5-text-to-text","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"grok-4.5-text-to-text","choices":[{"index":0,"delta":{"content":"Here is a concise explanation"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"grok-4.5-text-to-text","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"grok-4.5-text-to-text","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":8,"total_tokens":20}}

data: [DONE]

Phản hồi lỗi

textSao chép
event: error
data: {"error":{"message":"API requests too frequent, exceeding rate limit","type":"rate_limit_error","code":"1302","param":null}}

Phương pháp hay nhất

1. Sử dụng tin nhắn có cấu trúc: Gửi lịch sử hội thoại qua messages[] thay vì dồn ngữ cảnh vào một câu lệnh duy nhất.
2. Chọn đúng biến thể mô hình: Sử dụng Text to Text để suy luận chỉ với văn bản và Image to Text khi cần hiểu hình ảnh.
3. Tiếp nhận sự kiện SSE: Nối thêm choices[0].delta.content để hiển thị trực tuyến và xem data: [DONE] là hoàn tất thành công.
4. Chỉ gửi đầu vào được hỗ trợ: Text to Text không hỗ trợ tệp đính kèm hình ảnh hoặc tệp thông thường.