Claude Opus 5.5 API

Tài liệu tham chiếu API đầy đủ cho các mô hình LLM Claude Opus 5.5 do Anthropic cung cấp.

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

API này hỗ trợ hai biến thể mô hình Claude Opus 5.5:

So sánh nhanh

Claude Opus 5.5 Text to Text

Điểm cuối

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

Tham số yêu cầu

Bắt buộc

Nội dung được hỗ trợ trong 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: 'claude-opus-5.5-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Draft a technical decision memo for this architecture choice.'
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Claude Opus 5.5 File Analysis

Điểm cuối

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

Tham số yêu cầu

Bắt buộc

Nội dung được hỗ trợ trong 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: 'claude-opus-5.5-file-analysis',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'Summarize this file and extract the key risks.' },
          {
            type: 'file',
            file: {
              filename: 'demo.pdf',
              file_data: 'https://example.com/demo.pdf'
            }
          }
        ]
      }
    ],
    stream: true,
    max_tokens: 4096
  })
});

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

Các mô hình LLM Claude Opus 5.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 là sự kiện do máy chủ gửi (SSE); 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":"claude-opus-5.5-file-analysis","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-opus-5.5-file-analysis","choices":[{"index":0,"delta":{"content":"Here is a concise summary"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-opus-5.5-file-analysis","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-opus-5.5-file-analysis","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}}

Các phương pháp thực hành tốt nhất

1. Dùng tin nhắn có cấu trúc: Gửi lịch sử hội thoại qua messages[] thay vì gộp ngữ cảnh vào một lời nhắc.
2. Chọn đúng biến thể mô hình: Dùng Text to Text để suy luận và viết chỉ với văn bản, dùng File Analysis khi cần tệp hoặc hình ảnh.
3. Xử lý sự kiện SSE: Nối thêm choices[0].delta.content để hiển thị dạng luồng và coi data: [DONE] là hoàn tất thành công.
4. Chỉ gửi đầu vào được hỗ trợ: Trong máy khách hiện tại, các mô hình văn bản bỏ qua những phần tệp và hình ảnh không được hỗ trợ.