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

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

Chỉnh suy nghĩ, công cụ, đệm Muse theo trang này. Cấu trúc đầy đủ: Chat Completions, Responses, Messages.

Mô hình áp dụng

Mô hình	Điểm sử dụng
muse-wonder-1.0	Ba giao thức, không tắt suy nghĩ; `max` là mức, không chuyển sang Muse Wonder Full
muse-spark-1.3	Cùng dạng yêu cầu, hỗ trợ `max`; giới hạn âm thanh xem bảng

Khác biệt Chat Completions

Trường	Khác biệt
`reasoning_effort`	Cả hai dùng `minimal/low/medium/high/xhigh/max`; bỏ vẫn suy nghĩ, `none` trả `400`
`max_completion_tokens`	Ngân sách chung suy nghĩ/trả lời; tên cũ `max_tokens` vẫn nhận, không `max_output_tokens` Responses
`temperature/top_p`	Phạm vi `0～2`, `(0,1]`, mặc định đều `1`; thường giữ hoặc chỉnh một; `top_p: 0` trả `400`
`n`	Chỉ `1`; trên `1` trả `400`
Cấu hình không tương thích	`stop`, `verbosity`, `logit_bias`, `prediction`, `modalities`, `audio`, `web_search_options` không hỗ trợ, không sao chép ví dụ chung
Phạt và Logprobs	`frequency_penalty/presence_penalty` không hỗ trợ, có thể lỗi; `logprobs: true` trả `400`
`tool_choice`	Chỉ `auto`; `none`, `required`, hàm chỉ định trả `400`; tên hàm tối đa một dấu chấm
`reasoning_content`	API ngoài gốc không trả suy nghĩ nguyên bản đọc được; không dựa trường này giữ qua lượt. Dùng Responses / Messages
`strict`	Hàm và đầu ra cấu trúc mặc định `false`; khi bật, mọi đối tượng cần `additionalProperties: false`, liệt kê hết thuộc tính trong `required`; gốc đối tượng thường, không `oneOf/allOf`

Khác biệt Responses

Trường	Khác biệt
`reasoning.effort`	Sáu mức như Chat, không `none`; `reasoning.summary` yêu cầu tóm tắt nhưng không thay lịch sử mã hóa
`max_output_tokens`	Tối thiểu `16`, gồm suy nghĩ/trả lời; đầu vào cùng ngân sách phải vừa ngữ cảnh
`include`	Yêu cầu mã hóa qua `reasoning.encrypted_content`, mặc định không trả; với `store: false`, gửi mọi mục nguyên trạng, không sửa mã hóa
`previous_response_id`	Tiếp tục lịch sử/suy nghĩ máy chủ đã lưu; chọn nó hoặc thủ công, không coi chỉ văn bản cuối là đủ
`truncation`	Chỉ mặc định `disabled`; `auto` trả `400`; tự quản lý lịch sử dài
`background/stream`	Tạo yêu cầu không đặt cả hai `true`, nếu không `400`; tác vụ nền sau đó tra hoặc streaming được
`tool_choice`	Cũng chỉ `auto`; `web_search`, `tool_search` cho tìm kiếm máy chủ/phát hiện công cụ, Chat không có
`text.format/strict`	Dùng cấu hình Responses; `response_format` cấp cao dù nhận tương thích vẫn không đặt định dạng; mặc định/giới hạn nghiêm ngặt như trên
Logprobs và sử dụng streaming	Yêu cầu `message.output_text.logprobs` trả `400`; phản hồi cuối có usage, `stream_options.include_usage` Chat không hiệu lực

Khác biệt Messages

Trường	Khác biệt
`max_tokens`	Bắt buộc tối thiểu `1`; dự trù suy nghĩ/trả lời, không dùng tên/tối thiểu Responses
`thinking/output_config.effort`	Nên `thinking.type: adaptive` với `low/medium/high/xhigh/max`; không dùng `minimal` hay `disabled` để tắt suy nghĩ
`thinking.budget_tokens`	`enabled` cũ được nhận nhưng không ánh xạ mức; ngân sách ít nhất `1024`, dưới `max_tokens`; độ sâu dùng `output_config.effort`
`thinking.display`	`summarized` trả tóm tắt, `omitted` chỉ giữ mã hóa; gửi nguyên khối, nhất là `redacted_thinking`
`temperature`	Phạm vi `0～1`, không áp trần Chat / Responses; thường bỏ lấy mẫu
Trường không tương thích	`top_k`, `stop_sequences`, `inference_geo` chính thức không hỗ trợ, bị từ chối
`tool_choice`	Nhận `auto/any/none`, không `{type: "tool"}` để chỉ định công cụ; `disable_parallel_tool_use: true` hạn chế song song
`output_config.format`	Cấu trúc qua `{type: "json_schema", schema: ...}`; `citations.enabled: true` khối document không hỗ trợ
Tìm kiếm và lịch sử	Tìm bằng `web_search`; `allowed_domains/blocked_domains/max_uses` trả `400`. Messages gốc không lưu hội thoại, mỗi lượt gửi toàn bộ thông điệp/kết quả; không có tương đương `previous_response_id`

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

Trường	Khác biệt
Đệm tiền tố tự động	Không công tắc; chỉ dẫn, ví dụ, tài liệu ổn định trước, biến sau, tiền tố tái dùng giống nhau
`prompt_cache_key`	ID nhóm tùy chọn Chat / Responses theo tiền tố chung; không tạo khác từng người/yêu cầu để tránh phân tán định tuyến
`prompt_cache_retention`	Responses dùng `in_memory/24h` gợi ý lưu giữ, máy chủ quản lý; không sao chép trường OpenAI mới hoặc coi trường này ngừng khuyến nghị
`cache_control`	Messages nhận dấu cấp cao, khối, công cụ; `ttl` chỉ `5m`, không `1h` Claude
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`; ID không chứng minh trúng

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 `image_url.url`, Responses `input_image` với `image_url` chuỗi; URL công khai/Base64, tham chiếu gốc từ Files tương ứng
Video	`input_video`	Responses dùng `video_url`, `file_id`, video tải lên thêm `input_file`; Chat khối `video_url`, không lẫn cấu trúc
Âm thanh	`input_audio`	Chat / Responses: Base64 thô trong `input_audio.data`, định dạng `input_audio.format`; Responses thêm `audio_url` Base64 Data URL hoặc `file_id` gốc
PDF	`file`	Chat `file.file_data/file_id`, Responses `input_file`, Messages `document`; không dùng trường ảnh
Media	`image/video`	Messages dùng nguồn `base64/url/file` trong `source`; `video` mở rộng Meta

Giới hạn	Mô tả
Hình ảnh	Ảnh nội tuyến tối đa `50 MB` (`50000000` byte) mỗi ảnh, tối đa `50` mỗi yêu cầu; còn giới hạn thân/ngữ cảnh; đặt trong user
Âm thanh Spark 1.3	Hiểu âm thanh chưa đầy đủ; đầu vào âm thanh có thể giảm chất lượng
Đầu ra	Cả hai chỉ xuất văn bản; nhận ảnh/âm thanh/video không nghĩa sinh các media đó

Ví dụ gọi

Thay MODEL_ID bằng ID đầy đủ, định danh đệm theo tiền tố chung ứng dụng. Ba ví dụ mức thấp, ngân sách rõ.

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,
    "prompt_cache_key": "YOUR_SHARED_PREFIX"
  }'