Khác biệt tham số và giao thức của Hunyuan

Tìm hiểu khác biệt tham số và cách dùng mô hình Hunyuan qua các giao thức tương thích.

Với Hunyuan, chỉnh tham số theo trang này. Cấu trúc đầy đủ: Chat Completions, Responses, Messages.

Mô hình áp dụng

Mô hình	Phạm vi
hy4-preview	Chat, Responses, Messages; mức Chat `none/high`, mặc định `high`
hy3	Chat, Responses, Messages; mức Chat `none/low/high`, mặc định `high`; giữ suy nghĩ/giới hạn công cụ theo bảng

Khác biệt Chat Completions

Trường	Khác biệt
`thinking.type`	Cả hai mặc định suy nghĩ; công tắc `enabled/disabled`; mức `reasoning_effort` xem bảng trên
`reasoning_effort`	Hy3 với `tools`, `low` ánh xạ `high`; mô hình quyết định độ sâu theo tác vụ công cụ
`max_tokens`, `max_completion_tokens`	Cả hai giới hạn tổng suy nghĩ/trả lời, trường sau ưu tiên. Hy3 suy nghĩ khuyến nghị ít nhất `16000`, không phải tối thiểu bắt buộc
`top_k`, `repetition_penalty`	Bỏ qua âm thầm khi truyền, không coi như mở rộng Qwen
`n`	Phải `1` khi suy nghĩ
`preserved_thinking`	Công tắc giữ suy nghĩ Hy3; có `tools` mặc định bật, văn bản thường tắt; tên đúng `preserved_thinking`
Lịch sử `reasoning_content`	Khi gửi kết quả, giữ toàn bộ suy nghĩ assistant trước và `tool_calls`. Bật giữ không tự bù lịch sử máy khách
`tool_choice`	Suy nghĩ dùng `auto/none`, không dùng `required` hay ép hàm
`web_search_options`	Tìm kiếm gốc Hy3: `enable: true`; `search_source` dùng `standard/lite`, mặc định `standard`. Dòng chỉ áp Hy3

Khác biệt Responses

Trường	Khác biệt
`max_output_tokens`	Gồm suy nghĩ/trả lời, đừng chỉ dự trù văn bản hiển thị
`tool_choice`	Hy3 chỉ `auto/none`, không `required` hay đối tượng chỉ định hàm
`previous_response_id`	Hy3 trả `400` với giá trị không rỗng; hội thoại tự gửi lịch sử trong `input`
`reasoning.preserved_thinking`	Giữ suy nghĩ Hy3 trong đối tượng `reasoning`, mặc định như Chat
`text.format`	Hỗ trợ `text/json_object/json_schema`; JSON Schema Hy3 cần `additionalProperties: false`
`web_search` trong `tools`	Tìm kiếm Hy3 dùng `type: "web_search"`, vị trí khác `web_search_options` Chat

Khác biệt Messages

Trường	Khác biệt
`thinking.type`, `max_tokens`	Công tắc `enabled/disabled`; `max_tokens` gồm suy nghĩ/trả lời; dành chỗ cho trả lời khi đặt `budget_tokens`
`HY-Preserved-Thinking`	Header giữ suy nghĩ Hy3, hỗ trợ `true/false`, bỏ thì theo mặc định; không đưa trường cấp cao Chat vào Messages
Lịch sử khối thinking	Giữ assistant thực tế cùng kết quả; Hy3 thiếu `signature` thì không tự tạo chữ ký, không áp quy tắc Claude

Khác biệt bộ nhớ đệm

Trường	Khác biệt
`prompt_cache_key`	Định danh đệm Chat; tiền tố và giá trị ổn định, xác nhận trúng từ phản hồi
Giữ suy nghĩ và đệm	Giữ suy nghĩ để tiếp tục suy luận, không có nghĩa trúng đệm; lịch sử đầy đủ ổn định giúp tái dùng tiền tố
Mức sử dụng đệm	Chat `usage.prompt_tokens_details.cached_tokens`; Responses `usage.input_tokens_details.cached_tokens` thực tế; Messages `usage.cache_read_input_tokens` thực tế

Ví dụ gọi

Thay MODEL_ID bằng ID đầy đủ, dùng API Key riêng. Mọi ví dụ dùng văn bản.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Giải thích cách xử lý thời gian chờ API bằng ba ý"}],
    "reasoning_effort": "high",
    "max_completion_tokens": 16384
  }'