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

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

Với DeepSeek, 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
deepseek-flash	Chat, Responses, Messages; hỗ trợ ảnh
deepseek-v4-pro	Chat, Responses, Messages; không ảnh, Responses hỗ trợ tìm kiếm máy chủ

Khác biệt Chat Completions

Trường	Khác biệt
`thinking.type`	Cả hai mặc định suy nghĩ, hỗ trợ `enabled/disabled`
`reasoning_effort`	`none` tắt, `low/high/max` bật, mặc định `high`; ánh xạ `minimal` sang `low`, `medium/xhigh` sang `high`, `ultra` sang `max`
`temperature`	Phạm vi `0～2`; bị bỏ qua khi suy nghĩ
`top_p`	Flash: khi suy nghĩ phạm vi hiệu lực `0.95～1`, dưới `0.95` thành `0.95`; không suy nghĩ cố định `1`. Pro: bỏ giá trị khi suy nghĩ, có `tools` cố định `0.95`, còn lại `1`; có hiệu lực khi không suy nghĩ
`max_tokens`	DeepSeek vẫn dùng trường này, chưa ngừng khuyến nghị; phạm vi `1～393216`. Mặc định `8192` không suy nghĩ, `65536` có suy nghĩ, `131072` ở mức `max`
`presence_penalty`, `frequency_penalty`	Chính thức ngừng khuyến nghị; truyền không có hiệu lực
`stop`	Chuỗi hoặc mảng chuỗi; tối đa `16` chuỗi dừng
`response_format.type`	Hỗ trợ `text/json_object`; chế độ JSON phải yêu cầu rõ trong prompt
`tools`, `tool_choice`	Chỉ Function Tool; khi suy nghĩ, `required` hoặc chỉ định hàm trả `400`. Tắt suy nghĩ trước
Lịch sử `reasoning_content`	Khi suy nghĩ với `tools`, gửi mọi suy nghĩ assistant cũ kể cả lượt không gọi công cụ. Không có `tools`, suy nghĩ cũ bị bỏ qua
`stream_options.include_usage`	Chỉ cùng `stream: true`. Dù bật hay không, khối cuối có Usage đầy đủ, không có khối riêng `choices: []`. Khi bật, `usage` các khối trước là `null`
`user_id`	Mở rộng DeepSeek, tối đa `512` ký tự; chỉ chữ, số, gạch dưới/gạch nối. Cô lập người dùng, đệm và lập lịch; không chứa thông tin cá nhân

Khác biệt Responses

Trường	Khác biệt
`input`, `instructions`	Ít nhất một trường; `instructions` thành system đầu, vai trò `developer` được xem như `user`
`reasoning.effort`	Mặc định `high`, hỗ trợ `none/low/high/max`, ánh xạ theo bảng; `none` tắt suy nghĩ
`temperature`, `top_p`	Giá trị và hành vi theo bảng trên; chú ý Flash / Pro
`previous_response_id`, `conversation`, `store`	API phi trạng thái, bỏ qua giá trị; gửi lại lịch sử vào/ra, phản hồi cố định `previous_response_id: null`, `store: false`
`text.format`	Hỗ trợ `text/json_object/json_schema`; JSON Schema cần `name`, `schema`
`text.verbosity`, `reasoning.summary`	Trường đầu không tác dụng, trường sau không tạo tóm tắt; reasoning cũ chỉ văn bản rõ `content`, không `summary/encrypted_content`
`tools`	Function Tool được hỗ trợ; Custom Tool chỉ tên `apply_patch`, tên khác trả `400`. `web_search` chỉ Pro, Flash bỏ qua; `file_search`, `code_interpreter`, `computer_use`, `mcp` bị bỏ qua
`tool_choice`	Hỗ trợ `none/auto/required` và chỉ định Function Tool
`parallel_tool_calls`, `max_tool_calls`	Bỏ qua giá trị; luôn bật công cụ song song, phản hồi `parallel_tool_calls` cố định `true`
`truncation`	Bỏ qua, không tự cắt; đầu vào quá ngữ cảnh trả `400`
`background`, `metadata`, `include`, `prompt`	Giá trị bị bỏ qua
`service_tier`, `safety_identifier`, `context_management`, `stream_options`	Giá trị bị bỏ qua

Khác biệt Messages

Trường	Khác biệt
`anthropic-version`	DeepSeek bỏ Header này, không đổi quy tắc theo ngày phiên bản Anthropic
`thinking`, `output_config.effort`	Mặc định suy nghĩ; `thinking.type` nhận `enabled/disabled`, bỏ `budget_tokens`. Mức `low/high/max`, mặc định `high`, ánh xạ theo Chat; `output_config` chỉ `effort`
`temperature`, `top_p`	Giá trị/hành vi theo Chat; `top_k` bỏ qua
`tool_choice.type`	Hỗ trợ `none/auto/any/tool`; bỏ qua `disable_parallel_tool_use`
`metadata`	Chỉ `user_id`, bỏ qua các trường khác
`container`, `mcp_servers`, `service_tier`	Giá trị bị bỏ qua
Văn bản và kết quả công cụ	Bỏ `citations` của văn bản và `is_error` của kết quả; dấu đệm xem bảng
Khối nội dung	Không hỗ trợ `document`, `search_result`, `redacted_thinking`, `code_execution_tool_result`, `mcp_tool_use`, `mcp_tool_result`, `container_upload`

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

Trường	Khác biệt
Đệm tiền tố tự động	Mặc định bật không cần cấu hình; chỉ tiền tố khớp hoàn toàn đơn vị đã ghi mới có thể trúng, không phải mọi đoạn giống nhau
`prompt_cache_key`, `prompt_cache_retention` của Responses	Bỏ qua giá trị, hệ thống tự quản lý đệm
`cache_control` của Messages	Bỏ qua dấu trong khối và định nghĩa công cụ
Mức sử dụng đệm	Chat xem `usage.prompt_cache_hit_tokens`, `usage.prompt_cache_miss_tokens`; Responses xem `usage.input_tokens_details.cached_tokens`

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

Chỉ deepseek-flash nhận ảnh, deepseek-v4-pro không hỗ trợ.

Đầu vào	Khối giao thức	Khác biệt
Hình ảnh	`image_url`	Chat: `image_url.url` dùng URL công khai / Base64 Data URL
Hình ảnh	`input_image`	Responses: `image_url` URL công khai / Base64 Data URL trong user / developer hoặc đầu ra công cụ; ảnh trong system / assistant trả `400`
Hình ảnh	`image`	Messages: `url` cho `source.type=url`; `media_type`, `data` cho `source.type=base64`

Trường	Khác biệt
`detail`	Chat trong `image_url`, Responses trên khối; hỗ trợ `low/high/original/auto`, `low` thu về `512×512`, ba giá trị còn lại tương đương
Định dạng và kích thước ảnh	JPEG, PNG, GIF, WebP; tối đa `32 MiB` mỗi ảnh URL / Base64, thân `48 MiB`, tính cả mã hóa Base64
URL ảnh	Tối đa `8192` ký tự, tải xong trong `60` giây

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.cn/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 ý"}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'