GLM 매개변수 및 프로토콜 차이

호환 프로토콜에서 GLM 모델의 매개변수 차이와 사용 방법을 알아봅니다.

GLM은 선택한 프로토콜로 요청을 구성한 뒤 이 페이지의 공식 매개변수 차이를 적용하세요. 전체 구조는 Chat Completions, Responses, Messages를 참고하세요.

대상 모델

모델	적용 범위
GLM-5.3-FlashX, GLM-5.3-Flash	Chat 매개변수 차이 및 멀티모달 보충
GLM-5.3	Chat 및 Responses 매개변수 차이

GLM-5.3 텍스트 매개변수

Chat Completions

필드	차이 설명
`thinking.type`	추론이 항상 활성화되며 `enabled`만 지원, `disabled`은 미지원
`reasoning_effort`	`low/high/max` 지원, 기본값 `max`
`temperature`	범위 `0～1`, 기본값 `1`, 소수 둘째 자리까지
`top_p`	범위 `0.01～1`, 기본값 `0.95`, 소수 둘째 자리까지. 온도와 둘 중 하나만 조정
`do_sample`	GLM 확장, 기본값 `true`. `false`이면 `temperature`, `top_p` 무시
`max_tokens`	범위 `1～131072`, 추론과 최종 답변을 포함한 출력 예산
`tool_stream`	GLM 확장. 함수 인수를 스트리밍하려면 이 필드와 `stream`을 `true`로 설정
`thinking.clear_thinking`	`false`이면 추론 보존. 전체 추론 이력을 원래 순서대로 재전송
`reasoning_content`	추론 내용은 스트리밍 시 `delta.reasoning_content`으로 반환. 도구와 교차 추론하는 턴은 같은 메시지의 `tool_calls`과 함께 그대로 재전송
`request_id`	GLM 확장, 6～64자, UUID 가능. 생략하면 서비스가 생성
`user_id`	GLM 확장, 6～128자. 민감 정보 없는 안정적인 최종 사용자 ID 사용
`tool_choice`	GLM-5.3은 `auto`만 지원
`response_format.type`	GLM-5.3은 `text` 또는 `json_object` 지원

Responses

이 절은 GLM-5.3에 적용됩니다.

필드	차이 설명
`model`, `input`	둘 다 필수
`temperature`	범위 `0～1`, 기본값 `1`, 소수 둘째 자리까지
`top_p`	범위 `0.01～1`, 기본값 `0.95`, 소수 둘째 자리까지
`max_output_tokens`	추론과 답변 포함, 기본값 `65536`, 최대 `131072`
`reasoning.effort`	기본값 `max`. `low/medium`은 `high`, `xhigh`은 `max`로 매핑
`store`	기본값 `false`. 저장 또는 서버 대화 이력이 필요하면 `true` 명시
`previous_response_id`	저장된 응답을 이어가며 ID 유효 기간은 칠 일
`tool_choice`	`none` 또는 `auto` 지원
`tools[].type`	`function`, `namespace`, `custom`, `web_search` 지원
`text.format.type`	`text` 또는 `json_object` 지원

Flash / FlashX 멀티모달 보충

Flash / FlashX는 위 Chat 텍스트 매개변수를 공유합니다. GLM-5.3은 텍스트만 받으며 아래 블록은 사용하지 않습니다.

입력	Chat 콘텐츠 블록	주요 필드
이미지	`type: "image_url"`	`image_url.url`에 이미지 URL 또는 Base64 Data URL 사용, 여러 이미지는 각각 별도 블록
동영상	`type: "video_url"`	`video_url.url`
파일	`type: "file"`	`file.file_id`, `file.file_url`, `file.file_data` 중 하나, 파일당 최대 50 MB. 이전 `file_url` 블록은 호환용

호출 예제

MODEL_ID을 선택한 프로토콜에서 사용 가능한 전체 모델 ID로 바꾸고 본인 API Key를 사용하세요.

세 모델 모두 이 텍스트 설정을 사용할 수 있습니다.

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 시간 초과 진단 방법을 세 가지로 설명하세요"}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "low",
    "max_tokens": 4096
  }'