AGTCloud API Docs
Hướng dẫnAPI ReferenceTích hợp và tài nguyênCập nhật và hỗ trợ
Khác biệt tham số theo nhà cung cấp

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

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

Với Qwen, 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ìnhPhạm vi
qwen3.8-max-0902, qwen3.8-flash, qwen3.8-maxTất cả hỗ trợ Chat, Responses, Messages; quy tắc chung gộp lại, phạm vi media xem bảng

Khác biệt Chat Completions

TrườngKhác biệt
enable_thinking, reasoning_effortMặc định suy nghĩ; mức hiệu lực low/medium/xhigh, mặc định xhigh. minimal sang low, high/max sang xhigh, none tắt suy nghĩ
thinking_budgetKhông cùng reasoning_effort, nếu không gây lỗi. Chỉ định riêng mức thì low/medium/xhigh lần lượt tương ứng ngân sách 4096/16384/262144
max_tokens, max_completion_tokensmax_tokens chỉ giới hạn trả lời, chính thức sắp ngừng khuyến nghị; mới tích hợp dùng max_completion_tokens giới hạn tổng suy nghĩ/trả lời
temperaturePhạm vi [0,2); mặc định suy nghĩ: văn bản 1.0, thị giác 0.6; dưới 0.6 thành 0.6. Không suy nghĩ mặc định 0.7
top_p, top_ktop_p phạm vi (0,1], mặc định suy nghĩ / không 0.95/0.8. Mở rộng top_k nguyên không âm, mặc định 20; null hoặc trên 100 tắt Top-K
repetition_penaltyMở rộng Qwen, lớn hơn 0, mặc định 1.0; khác hai trường phạt OpenAI
preserve_thinkingMặc định bật; gửi nguyên suy nghĩ trong reasoning_content assistant, không ghép vào content. Không gửi suy nghĩ không tự gây lỗi
tool_choiceHỗ trợ auto/none; suy nghĩ không nhận required hay ép hàm. Không suy nghĩ được chỉ định hàm, nhưng required vẫn không đảm bảo gọi
tool_streamMặc định false; chỉ với stream=true mới xuất đối số phức tạp tăng dần. Max chỉ văn bản, Flash mọi phương thức
response_formatHỗ trợ json_object/json_schema; đầu yêu cầu từ JSON trong prompt, sau định nghĩa bằng response_format.json_schema; không cần tắt suy nghĩ
enable_search, search_optionsenable_search mặc định false; search_options.forced_search ép tìm kiếm. Các mô hình dùng turbo/max; với include_tool_usage=true, thống kê thực tế trong usage.x_tools

Khác biệt Responses

TrườngKhác biệt
reasoning.effortHỗ trợ none/low/medium/xhigh, mặc định xhigh; minimal sang low, high/max sang xhigh
enable_thinkingCông tắc tương thích sẽ ngừng hỗ trợ; nên dùng reasoning.effort. Cùng truyền thì reasoning.effort ưu tiên
max_output_tokensTối thiểu 16, gồm suy nghĩ và trả lời
text.formatHỗ trợ text/json_object/json_schema; JSON Schema trong text.format.json_schema chứa name/schema/strict, khác dạng phẳng giao thức gốc
tool_choiceHỗ trợ auto/none/required và đối tượng allowed_tools; required chỉ khi danh sách có một công cụ
toolsNgoài hàm có web_search, web_extractor, code_interpreter; trích web phải kèm tìm kiếm, trình thông dịch mã cần suy nghĩ
store, previous_response_id, conversationLưu lịch sử máy chủ; store mặc định true, ID hiệu lực 7 ngày. Hai trường sau không đồng thời
background và tham số mở rộng khácKhông chạy nền bất đồng bộ; tham số OpenAI không có trong Responses Reference chính thức bị bỏ qua

Khác biệt Messages

TrườngKhác biệt
thinking.typeHỗ trợ enabled/disabled, mặc định suy nghĩ; không dùng cấu hình Claude adaptive
output_config.effortDùng low/medium/xhigh, mặc định xhigh; high/max sang xhigh, không áp mọi ánh xạ Chat
thinking.budget_tokensChính thức sắp ngừng khuyến nghị; dùng output_config.effort cho mới. Giữ ngân sách cũ thì max_tokens phải lớn hơn nó
max_tokensBắt buộc; Qwen3.8 giới hạn tổng suy nghĩ và trả lời
temperature, messages[].roleNhiệt độ [0,2); ngoài vai trò user/assistant còn system
tool_result.contentKết quả công cụ dùng chuỗi; tuần tự hóa đối tượng/mảng trước, không dùng mảng khối Claude
output_config.formatHỗ trợ JSON Schema nghiêm ngặt; dùng type: "json_schema", Schema trong schema, additionalProperties phải false
web_search trong toolsTên tìm kiếm web_search, loại có ngày như web_search_20250305; HTTP / SDK còn cần định danh máy khách x-anthropic-billing-header: cc_entrypoint=cli; trong system

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

TrườngKhác biệt
Đệm ngầm địnhTự bật; tiền tố giống ít nhất 1024 Token, không đảm bảo luôn trúng
Đệm tường minh Chat / MessagesDấu cache_control: { type: "ephemeral" } trên khối, ít nhất 1024 Token, hiệu lực 5 phút, gia hạn khi trúng; tối đa 4 dấu
Vị trí đệm tường minhSystem phải dùng mảng khối. Định nghĩa công cụ tính trong tiền tố nhưng dấu chỉ trên định nghĩa bị bỏ qua. Không sao chép TTL/điểm ngắt khác của Reference chung
Đệm Session ResponsesHeader x-dashscope-session-cache: enable bật, mặc định disable; tắt Session không tắt đệm ngầm định tự động
Mức sử dụng đệmChat usage.prompt_tokens_details.cached_tokens; Responses usage.input_tokens_details.cached_tokens; Messages usage.cache_read_input_tokens, usage.cache_creation_input_tokens

Khác biệt đầu vào đa phương tiện

Đầu vàoKhối giao thứcKhác biệt
Hình ảnhimage_urlChat: image_url.url hỗ trợ URL công khai / Base64 Data URL
Videovideo_urlMở rộng Chat: video_url.url URL công khai / Base64 Data URL; fps trên khối cùng cấp video_url
Danh sách khungvideoMở rộng Chat: ảnh theo thời gian trong mảng video, ít nhất 4 khung
Hình ảnhinput_imageResponses: image_url chuỗi URL công khai / Base64 Data URL đầy đủ, không đối tượng lồng Chat
PDFinput_fileResponses chính thức liệt kê qwen3.8-max, qwen3.8-flash; PDF công khai qua file_url, tối đa 100 MB; không thêm tham số riêng OCR
Hình ảnhimageMessages: url cho source.type=url; media_type và Base64 thô data cho base64
VideovideoMở rộng Messages: URL công khai qua source hoặc media_type, Base64 thô data; không phải khối Claude gốc
TrườngKhác biệt
Điều khiển ảnh Chatmin_pixels/max_pixels trên khối điều chỉnh pixel; có vl_high_resolution_images=true cấp cao nhất thì max_pixels vô hiệu
Kích thước ảnhẢnh công khai tối đa 20 MB; trước Base64 tối đa 20 MB; Data URL sau mã hóa tối đa 20 MB trong Chat, 32 MB trong Messages
Giới hạn videoVideo công khai tối đa 2 GB, chuỗi Base64 nhỏ hơn 10 MB; chỉ hiểu hình, không âm thanh trong video
Phạm vi giao thứcBa mô hình không dùng API âm thanh Omni; input_audio/input_video Responses hiện chỉ Omni. Không đưa khối video Chat / Messages sang Responses

Ví dụ gọi

Thay MODEL_ID bằng ID mô hình đầy đủ và dùng API Key riêng.

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": "low",
    "max_completion_tokens": 4096
  }'

Tài liệu chính thức

Trên trang này