Muse 매개변수 및 프로토콜 차이
호환 프로토콜에서 Muse 모델의 매개변수 차이와 사용 방법을 알아봅니다.
Muse 추론/도구/캐시는 이 페이지에서 조정하세요. 구조: Chat Completions, Responses, Messages.
| 모델 | 사용 요점 |
|---|
| muse-wonder-1.0 | 세 프로토콜, 추론 해제 불가, max은 강도이지 Muse Wonder Full 전환 아님 |
| muse-spark-1.3 | 같은 형식, max도 지원, 음성 모델 제한은 표 |
| 필드 | 차이 설명 |
|---|
reasoning_effort | 둘 다 minimal/low/medium/high/xhigh/max, 생략해도 추론, none은 400 |
max_completion_tokens | 추론과 가시 답변 공통 예산. 기존 별칭 max_tokens 허용, Responses max_output_tokens 아님 |
temperature/top_p | 범위 0～2, (0,1], 기본 모두 1, 기본 유지 또는 하나만 조정. top_p: 0은 400 |
n | 1만, 1 초과 400 |
| 비호환 설정 | stop, verbosity, logit_bias, prediction, modalities, audio, web_search_options 미지원. 일반 예제에서 옮기지 않음 |
| 페널티와 Logprobs | frequency_penalty/presence_penalty 미지원, 오류 가능, logprobs: true은 400 |
tool_choice | auto만, none, required, 함수 지정은 400. 함수 이름 마침표 최대 하나 |
reasoning_content | 원본 외부 API는 읽는 원본 추론을 반환하지 않음. 이 필드로 턴 간 보존하지 말고 Responses / Messages 사용 |
strict | 함수/구조화 출력 기본 false, 활성화 시 객체마다 additionalProperties: false과 required에 모든 속성, 루트는 일반 객체, oneOf/allOf 금지 |
| 필드 | 차이 설명 |
|---|
reasoning.effort | Chat과 같은 여섯 강도, none 미지원. reasoning.summary은 요약, 암호화 이력 대체 아님 |
max_output_tokens | 최소 16, 추론/답변 포함, 입력과 예산도 컨텍스트 안이어야 함 |
include | reasoning.encrypted_content으로 암호화 요청, 기본 안 반환. store: false이면 모든 출력 항목 그대로 재전송 |
previous_response_id | 저장 이력/추론 서버 연장. 수동과 하나 선택, 최종 텍스트만으로 완전 재생 아님 |
truncation | 기본 disabled만, auto은 400, 긴 이력 직접 관리 |
background/stream | 생성 시 둘 다 true이면 400, 생성 후 백그라운드 조회/스트림 가능 |
tool_choice | auto만, web_search, tool_search는 서버 검색/도구 발견, Chat에는 없음 |
text.format/strict | Responses 구조 설정 사용. 최상위 response_format은 허용돼도 형식에 무효, 엄격 모드 위와 동일 |
| Logprobs와 스트리밍 사용량 | message.output_text.logprobs 요청은 400, 최종 응답에 사용량 포함, Chat stream_options.include_usage 무효 |
| 필드 | 차이 설명 |
|---|
max_tokens | 필수 최소 1, 추론/답변 확보, Responses 이름/최소값 적용 안 함 |
thinking/output_config.effort | thinking.type: adaptive과 low/medium/high/xhigh/max 권장, minimal나 disabled으로 끌 수 없음 |
thinking.budget_tokens | 이전 enabled은 허용하지만 강도 매핑 안 함. 예산 최소 1024, max_tokens 미만, 깊이는 output_config.effort |
thinking.display | summarized 요약, omitted 암호화만, 특히 redacted_thinking 포함 그대로 재전송 |
temperature | 범위 0～1, Chat / Responses 상한 아님, 일반적으로 생략 |
| 비호환 필드 | top_k, stop_sequences, inference_geo 명시 미지원, 전달 거부 |
tool_choice | auto/any/none 허용, {type: "tool"}로 도구 지정 불가, disable_parallel_tool_use: true로 병렬 제한 |
output_config.format | 구조는 {type: "json_schema", schema: ...}, 문서 citations.enabled: true 미지원 |
| 검색과 이력 | 검색 web_search, allowed_domains/blocked_domains/max_uses은 400. 원본 Messages는 대화 저장 안 함, 매번 전체 메시지/결과, previous_response_id 상당 입구 없음 |
| 필드 | 차이 설명 |
|---|
| 자동 접두사 캐시 | 스위치 불필요, 고정 지시/예/자료 앞, 변수 뒤, 접두사 동일 유지 |
prompt_cache_key | Chat / Responses 선택 그룹 ID, 공유 접두사 기준, 사용자/요청별로 분리해 라우팅 흩뜨리지 않음 |
prompt_cache_retention | Responses in_memory/24h은 보존 힌트, 서버 관리. OpenAI 신규 설정 전용하거나 폐기로 간주하지 않음 |
cache_control | Messages 최상위/블록/도구 표시 지원, ttl은 5m만, Claude 1h 불가 |
| 캐시 사용량 | Chat usage.prompt_tokens_details.cached_tokens, Responses usage.input_tokens_details.cached_tokens, Messages usage.cache_read_input_tokens, ID로 적중 보장 안 함 |
| 제한 | 설명 |
|---|
| 이미지 | 인라인 이미지 장당 최대 50 MB(50000000바이트), 요청당 50장, 본문/컨텍스트도 제한. user에 배치 |
| Spark 1.3 음성 | 음성 이해 완전 지원 아님, 음성 입력 시 품질 저하 가능 |
| 출력 | 둘 다 텍스트 출력. 이미지/음성/동영상 수신이 생성 지원은 아님 |
MODEL_ID을 전체 ID로 바꾸세요. 캐시 ID는 앱 공유 접두사 기준. 세 예제 모두 낮은 강도와 명시 예산입니다.
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": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096,
"prompt_cache_key": "YOUR_SHARED_PREFIX"
}'