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

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

Với Doubao, 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
doubao-seed-2-1-lite-260915, doubao-seed-evolving, doubao-seed-2-1-pro-260915	Tất cả hỗ trợ ba giao thức; gộp suy nghĩ/công cụ, âm thanh chỉ phạm vi Lite
doubao-seed-evolving	ID liên tục cập nhật, không phải cùng phiên bản với Pro có ngày; giữ cấu hình ổn định trong Session

Khác biệt Chat Completions

Trường	Khác biệt
`thinking.type`	Hỗ trợ `enabled/disabled`, mặc định suy nghĩ
`reasoning_effort`	Mặc định `high`, mức hiệu lực `low/medium/high`, `minimal` tắt; `none` sang `minimal`, `xhigh/max` sang `high`
`max_tokens`	Mặc định `4096`, chỉ câu trả lời không suy nghĩ, không phải ngân sách tổng
`max_completion_tokens`	Gồm suy nghĩ/trả lời, phạm vi Chat chính thức `1～65536`, loại trừ `max_tokens`; không áp giới hạn đầu ra trong thông số mô hình vào đây
`temperature`, `top_p`	Phạm vi `[0,2]`, `[0,1]`; không theo quy tắc cố định nhiệt độ `1` của một số Seed 2.0 cũ
`frequency_penalty`, `presence_penalty`	Seed 2.0 trở lên không hỗ trợ; giới hạn khả năng, không phải ngừng khuyến nghị
`stop`, `logprobs`	Mặc định không hỗ trợ ở mô hình suy nghĩ sâu; cả ba không nằm trong ngoại lệ chính thức
`reasoning_content`, `encrypted_content`	Mặc định trả tóm tắt và nguyên bản mã hóa; công cụ nhiều lượt gửi nguyên `encrypted_content`. Tóm tắt không thay thế, mã hóa ưu tiên nếu gửi cả hai
`stream_options.chunk_include_usage`	Mặc định `false`; `true` trả sử dụng tích lũy mỗi khối; không cộng lại các số tích lũy
`stream_options.include_usage`	Điều khiển khối tổng cuối; Lite mặc định có, mô hình khác cần bật. Tích lũy mỗi khối khác tổng cuối
`response_format`	Hỗ trợ `json_object/json_schema`, giữ nhãn Beta chính thức; `strict: true` chỉ ràng buộc tập con Schema hỗ trợ, không mọi từ khóa JSON Schema

Khác biệt Responses

Trường	Khác biệt
`reasoning.effort`	Dùng `minimal/low/medium/high` và ánh xạ tương thích, mặc định như Chat; không đặt cấp cao nhất
`max_output_tokens`	Gồm suy nghĩ/trả lời, không dùng cách tính hay giới hạn Chat chỉ trả lời
`text.format`	JSON Schema trong `text.format` với `name/schema/strict`, không cấu trúc lồng Qwen `text.format.json_schema`
`store`, `previous_response_id`	`store` mặc định `true`; ID thực tiếp tục lịch sử và suy nghĩ gốc; `instructions` trước không tự kế thừa
Gửi lại lịch sử thủ công	Không dùng ID thì gửi đầy đủ reasoning, thông điệp và gọi công cụ; không thay mã hóa bằng tóm tắt
`max_tool_calls`	Phạm vi `1～10`, giới hạn số vòng công cụ tích hợp, không số lần trong một vòng; cố gắng tối đa, không trần cứng mọi hàm
`service_tier`, `store`	Trong chế độ gốc `flex`, `store` chỉ `false`, không đồng thời lưu phản hồi máy chủ

Khác biệt Messages

Trường	Khác biệt
`max_tokens`	Chính thức tùy chọn khác Claude bắt buộc; ví dụ vẫn đặt ngân sách rõ
`output_config.effort`	Điều chỉnh độ sâu theo mặc định/ánh xạ mô hình; không đưa trường cấp cao Chat vào đây
`output_format`	Mở rộng cấp cao, hỗ trợ `text/json_object/json_schema`; Schema trong `output_format.schema`, không `output_config.format` Claude
`temperature`, `top_p`	Phạm vi `[0,2]`, `[0,1]`, kể cả `top_p: 0` hợp lệ
`stop_sequences`	Trường chung nhận chuỗi/mảng, nhưng suy nghĩ sâu mặc định không hỗ trợ; có trường không đảm bảo dừng
Lịch sử khối thinking	Gửi đầy đủ `thinking`, `signature` thực tế, giữ giá trị/thứ tự; không tự tạo chữ ký hay tái dựng bằng tóm tắt

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

Trường	Khác biệt
Đệm ngầm định	Chat / Responses tự bật, không tắt được; tiền tố giống ít nhất `1024 Token`, không đảm bảo trúng
`prompt_cache_key`	Gợi ý định tuyến đệm Chat / Responses, giữ ổn định mỗi hội thoại; cùng key không đảm bảo máy cố định hay trúng
Responses `caching`	Đệm tường minh gốc bật bằng `type: "enabled"`; `prefix: true` chỉ ghi tiền tố không trả lời, `false` sinh và ghi bình thường
Giới hạn kết hợp `caching`	Không cùng `instructions` hoặc `tools` không phải Function; không áp TTL / Header Session hãng khác
Mức sử dụng đệm	Chat `usage.prompt_tokens_details.cached_tokens`; Responses `usage.input_tokens_details.cached_tokens`; Messages `usage.cache_read_input_tokens`, `usage.cache_creation_input_tokens` thực tế

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

Đầu vào	Khối giao thức	Khác biệt
Hình ảnh	`image_url`	Chat: URL công khai / Base64 Data URL trong `image_url.url`, độ chi tiết trong `image_url.detail`
Video	`video_url`	Chat: video qua `video_url.url`, `fps` trong `video_url`, cùng cấp `url`
PDF	`file`	Chat: chọn một `file.file_url/file_data/file_id`; nội dung tệp hiện chỉ PDF
Âm thanh	`input_audio`	Chỉ Lite, Chat: chọn một `input_audio.url/data/file_id`; `data` Base64 thô kèm `format`
Hình ảnh	`input_image`	Responses: chuỗi `image_url` hoặc ID tệp gốc, không đối tượng Chat
Video	`input_video`	Responses: địa chỉ video trong chuỗi `video_url`, `fps` trên cùng khối
PDF	`input_file`	Responses: `file_url/file_data/file_id`, tệp URL / Base64 tối đa `50 MB`
Âm thanh	`input_audio`	Chỉ Lite, Responses: URL / Base64 Data URL trong `audio_url` hoặc ID gốc, khác `input_audio.data` Chat
Hình ảnh	`image`	Messages: URL công khai qua `source`, hoặc `media_type`, Base64 thô `data`
PDF	`document`	Messages: PDF qua `source` trong document, không đưa khối `file` Chat sang

Trường	Khác biệt
`fps`	Phạm vi `0.2～5`, mặc định `1`, vị trí hai giao thức khác như bảng
Âm thanh Lite	Tệp âm thanh tối đa `25 MB`, tổng âm thanh đơn thuần một yêu cầu `120 phút`; nhập qua Chat / Responses
Media Evolving	Hỗ trợ ảnh, hình video và tài liệu; không âm thanh hoặc tiếng video
ID tệp gốc	Từ Ark Files API, gắn dự án tải và loại tệp; không cam kết API tải AGTCloud tương đương

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
  }'