Claude Haiku 5.5

Dùng claude-haiku-5-5 với POST https://api.seedrouter.ai/v1/messages. Mô hình nhận văn bản, hình ảnh và tài liệu, trả về văn bản hoặc yêu cầu công cụ. Trang mô hình hiển thị đơn giá token hiện tại.

Đặc tả dưới đây theo tài liệu dành riêng cho mô hình của Anthropic, được kiểm tra ngày 9/10/2026. Giới hạn khả năng chính thức và xác minh toàn trình là hai việc riêng: trường được chấp nhận không chứng minh tác dụng dự kiến đã xảy ra. Xem kết quả tương thích bên dưới trước khi dùng tùy chọn nâng cao.

Bắt đầu nhanh

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Classify this request as billing, technical or account: I was charged twice. Return only the label."}]
  }'

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai",
)
message = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize the purpose of a database index."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: 'https://api.seedrouter.ai',
});
const message = await client.messages.create({
  model: 'claude-haiku-5-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Summarize the purpose of a database index.' }],
});
for (const block of message.content) {
  if (block.type === 'text') console.log(block.text);
}

Giữ khóa API trên máy chủ. Chọn khối phản hồi theo type; phản hồi có thể bắt đầu bằng suy luận hoặc lời gọi công cụ.

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    body, err := json.Marshal(map[string]any{
        "model": "claude-haiku-5-5",
        "max_tokens": 1024,
        "messages": []map[string]string{
            {"role": "user", "content": "Summarize the purpose of a database index."},
        },
    })
    if err != nil { panic(err) }
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/messages", bytes.NewReader(body))
    if err != nil { panic(err) }
    req.Header.Set("x-api-key", os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("anthropic-version", "2023-06-01")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 2 * time.Minute}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    data, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    if res.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, data)) }
    fmt.Println(string(data))
}

Tham số yêu cầu

Đặc tả gốc có 25 trường cấp cao nhất. Tùy chọn không có nghĩa là nhận null: chỉ các hàng nêu rõ null mới chấp nhận giá trị đó. Trường không xác định và trường lấy mẫu không được hỗ trợ bị loại bỏ trước khi chuyển tiếp, theo chính sách tham số mô hình văn bản. Giá trị không hợp lệ của trường được hỗ trợ trả về invalid_request_error trước khi tạo nội dung.

Playground có điều khiển cho trường được hỗ trợ, gồm cả điều khiển JSON cho cấu trúc lồng nhau. Tham số lấy mẫu và tốc độ standard cố định được bỏ khỏi biểu mẫu. ID mô hình cố định theo trang này. Dùng bản xem trước yêu cầu JSON để kiểm tra phần thân được gửi.

Suy luận và mức nỗ lực

Mặc định là suy luận thích ứng với mức nỗ lực medium và không hiển thị văn bản suy luận. Effort nhận low, medium, high, xhigh, max hoặc null để dùng mặc định.

{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}

Để tắt suy luận, dùng {"type":"disabled"} với mức nỗ lực low, medium hoặc high. Không thêm display hoặc block_binding trong chế độ disabled. enabled, budget_tokens, between_tools và tắt suy luận ở xhigh/max không hợp lệ.

Với adaptive, display nhận omitted, summarized hoặc null. Giá trị beta chung updates cần thinking-display-updates-2026-08-18; Anthropic hiện chưa xác nhận cập nhật tiến độ đọc được cho Haiku, nên không phụ thuộc vào đầu ra đó.

thinking.block_binding tùy chọn cần thinking-binding-controls-2026-08-01. Nó là null hoặc đối tượng có prefix_mismatch_behavior là error, drop_block hoặc null. Giữ nguyên lượt hội thoại trước và toàn bộ khối suy luận khi gửi lại lịch sử. Chữ ký suy luận gắn với tài khoản tạo ra chúng hoặc tài khoản liên kết với tài khoản đó.

output_config.task_budget là null hoặc { "type": "tokens", "total": 20000 } với remaining tùy chọn là số nguyên/null. Cần task-budgets-2026-03-13; total phải ít nhất 20000. Không áp đặt thêm phạm vi cho remaining tại đây.

Công cụ và đầu ra có cấu trúc

Công cụ phía khách cần tên gồm 1–128 chữ cái, chữ số, dấu gạch dưới hoặc gạch nối, cùng input_schema có type: "object". Dùng tool_choice: {"type":"any"} hoặc {"type":"tool","name":"lookup"} để buộc gọi công cụ đã khai báo. Với suy luận thích ứng, phản hồi buộc dùng công cụ bắt đầu ở lời gọi công cụ, không có khối suy luận.

disable_parallel_tool_use là boolean tùy chọn cho lựa chọn auto, any và tool; không phải trường của none. Gửi lại kết quả công cụ với tool_use_id gốc. Playground hiển thị lời gọi nhưng không thực thi công cụ phía khách của bạn.

{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}

Phản hồi có cấu trúc dùng output_config.format: {"type":"json_schema","schema":{...}}. Tuân theo tập con JSON Schema được Anthropic hỗ trợ, gồm additionalProperties: false trên đối tượng. Cấu trúc hợp lệ không đảm bảo giá trị đúng về mặt thực tế. Công cụ strict và đầu ra có cấu trúc có giới hạn trên toàn schema; xem tham chiếu đầu ra có cấu trúc chính thức.

Sử dụng máy tính cần computer_toolset_20260801; phiên bản công cụ máy tính cũ không hợp lệ. Sử dụng trình duyệt có browser_toolset_20260801 riêng. Khai báo công cụ không xác minh một phiên công cụ máy chủ hoàn chỉnh hoạt động. Xem hướng dẫn chính thức của công cụ và yêu cầu beta trước khi dùng.

Hội thoại và quản lý ngữ cảnh

Không hỗ trợ điền trước assistant thông thường. Tiếp tục công cụ máy chủ đang tạm dừng là trường hợp khác: gửi lại toàn bộ khối assistant theo giao thức Messages.

Tin nhắn hệ thống có nội dung có thể xuất hiện sau tin nhắn người dùng hoặc kết quả công cụ máy chủ tạm dừng. Sau nó phải là tin nhắn assistant, hoặc nó phải là tin nhắn cuối. Các tin nhắn hệ thống liên tiếp được đánh giá như một nhóm. Không chèn tin nhắn này giữa lời gọi công cụ phía khách và kết quả bắt buộc của nó.

Tin nhắn hệ thống không có nội dung chỉ có thể thay đổi output_config.effort với mid-conversation-output-config-2026-07-01. Nó có thể xuất hiện ở bất kỳ đâu. Khi tắt suy luận, nó không thể đổi mức nỗ lực có hiệu lực. clear_at của hệ thống nhận never, next_user_message hoặc null với mid-conversation-system-clear-at-2026-08-21; tin nhắn giới hạn theo lượt chỉ cho phép văn bản, không có cấu hình đầu ra hoặc lưu đệm khối.

Các chỉnh sửa ngữ cảnh gồm:

compaction theo yêu cầu cần compact-2026-09-04. Không thể kết hợp với context_management, stop_sequences, định dạng đầu ra, buộc dùng công cụ hoặc task_budget.remaining. Khối nén có chữ ký cũng không thể kết hợp với task_budget.remaining hoặc nén theo ngưỡng. Giữ khối và chữ ký được trả về khi tiếp tục.

Hình ảnh, PDF và kích thước yêu cầu

Hình ảnh nhận JPEG, PNG, GIF và WebP qua URL, base64 hoặc tham chiếu tập tin. PDF nhận URL, base64 hoặc tham chiếu tập tin. Tham chiếu tập tin cần beta Files API tương ứng và quyền truy cập hợp lệ. Tài liệu văn bản có thể dùng nguồn văn bản hoặc nội dung.

Giới hạn yêu cầu gốc là 32 MB. Giới hạn hình ảnh chính thức là tối đa 600 ảnh, 10 MB dữ liệu mã hóa base64 mỗi ảnh và 8000 pixel trên mỗi cạnh; yêu cầu nhiều ảnh có thể chịu giới hạn chặt hơn tùy nền tảng. PDF phải không mã hóa và có tối đa 600 trang cho kích thước ngữ cảnh của mô hình này. API vẫn chịu trách nhiệm kiểm tra tập tin từ xa; kiểm tra cấu trúc cục bộ không chứng minh nội dung URL.

Playground tải lên tệp đính kèm trước khi gửi URL. JSON hội thoại cũng hỗ trợ khối nội dung phương tiện gốc. Kiểm tra đầy đủ ranh giới kích thước phương tiện và cửa sổ ngữ cảnh là việc riêng với yêu cầu ví dụ nhỏ.

Lưu đệm prompt và tính phí

Prompt tối thiểu có thể lưu đệm của Haiku là 512 token. Prompt ngắn hơn được đánh dấu có thể chạy mà không tạo mục bộ nhớ đệm. Dùng tối đa bốn điểm lưu đệm; điều khiển bộ nhớ đệm tự động cấp cao nhất chiếm một vị trí. Đặt tiền tố có thời gian tồn tại dài hơn trước tiền tố ngắn hơn.

max_tokens: 0 yêu cầu làm nóng bộ nhớ đệm mà không tạo câu trả lời. Không thể kết hợp với stream: true, đầu ra có cấu trúc hoặc buộc dùng công cụ. Giữ thiết lập suy luận và mức nỗ lực nhất quán giữa chuẩn bị bộ nhớ đệm và yêu cầu tái sử dụng nó.

Đọc usage.input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens và phân tách 5m/1h trong cache_creation. Suy luận được tính trong token đầu ra; số token suy luận được ghi riêng không phải phí bổ sung để cộng lần nữa. Đơn giá hiện tại ở phần giá, giải thích thêm trong hướng dẫn giá.

Phản hồi, truyền luồng và lỗi

Phản hồi hoàn tất chứa id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence và usage. Các trường tùy chọn container, diagnostics, context_management, stop_details và input_transformations được giữ lại khi được trả về.

Xử lý end_turn, max_tokens, stop_sequence, tool_use, pause_turn, compaction, refusal và model_context_window_exceeded. Dừng do giới hạn hoặc từ chối không giống lỗi HTTP. Không bao giờ coi khối nội dung đầu tiên chắc chắn là văn bản.

Truyền luồng dùng sự kiện SSE Messages: message_start, content_block_start, content_block_delta, content_block_stop, message_delta và message_stop. Cũng xử lý sự kiện ping và error. Giữ chữ ký suy luận và khối công cụ cần cho các lượt sau.

Lỗi dùng cấu trúc Anthropic:

{"type":"error","error":{"type":"invalid_request_error","message":"max_tokens must be an integer from 0 to 128000."}}

Yêu cầu trả về lỗi không bị tính phí. Xem xử lý lỗi cho các loại lỗi dùng chung.

Định dạng tương thích OpenAI

Cùng ID được cung cấp với /v1/chat/completions và /v1/responses. Dùng trường gốc của chúng: Chat dùng messages; Responses dùng input. Tùy chọn Claude gốc thuộc Messages, không nên sao chép toàn bộ vào phần thân theo định dạng OpenAI.

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'

curl https://api.seedrouter.ai/v1/responses \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_output_tokens":256,"input":"Reply with OK."}'

Kết quả tương thích

Kiểm tra ngày 9/10/2026 trong môi trường phát triển. Các kiểm tra xác nhận hành vi quan sát được của yêu cầu cụ thể, không phải mọi giới hạn chính thức hoặc triển khai sản xuất.

Tính phí ghi bộ nhớ đệm một giờ và nén chưa vượt xác minh phát hành. Chưa kiểm thử chạy ngữ cảnh/đầu ra tối đa, công cụ được lưu trữ với phí riêng, truy cập Files API và đổi fallback-credit. Giữ cấu trúc yêu cầu chính thức; không suy ra hỗ trợ chỉ từ trạng thái thành công.

Tài liệu tham khảo

• Tổng quan mô hình Haiku 5.5
• Hướng dẫn chuyển đổi Haiku 5.5
• Tham chiếu Messages
• Tham chiếu Beta Messages
• Suy luận, mức nỗ lực, ngân sách tác vụ
• Nén theo yêu cầu, chỉnh sửa ngữ cảnh
• Lưu đệm prompt, hình ảnh, hỗ trợ PDF