텍스트 모델고급 사용자업데이트
POST/v1/chat/completions
GLM 5.3 Flash
요청 ID glm-5.3-flash
프로토콜
POST /v1/chat/completions· Chat Completions 예시POST /v1/messages· Anthropic Messages 예시POST /v1/messages/count_tokens· Count Tokens 예시
인증
요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.
Authorization: Bearer YOUR_API_KEY- Anthropic Messages ·
x-api-key: YOUR_API_KEY
요청 매개변수
POST /v1/chat/completions
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 glm-5.3-flash로 설정하세요. |
messages | object[] | 필수 | 대화 순서대로 메시지를 보냅니다. 각 메시지에는 role과 content가 들어갑니다. |
messages[].content | string / object[] | 조건부 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
messages[].content[] | object | 조건부 | 이미지에는 type: image_url 콘텐츠 블록을 사용합니다. 허용 형식은 엔드포인트에 따라 다릅니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
max_completion_tokens | integer | 조건부 | 해당하는 추론 토큰을 포함한 생성 토큰 수의 상한입니다. 이 필드를 지원하는 엔드포인트에서 사용하세요. |
max_tokens | integer | 조건부 | 출력 토큰 제한을 위한 호환 필드입니다. 엔드포인트에 따라 이 필드와 max_completion_tokens 중 하나를 사용하세요. |
temperature | number | 조건부 | 샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다. |
top_p | number | 조건부 | 누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요. |
response_format | object | 조건부 | 구조화된 출력에는 type: json_object를 사용하거나, 스키마를 지원할 때 type: json_schema와 json_schema를 함께 지정하세요. |
tools | object[] | 조건부 | 모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다. |
tool_choice | string / object | 조건부 | 도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요. |
POST /v1/messages
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 glm-5.3-flash로 설정하세요. |
messages | object[] | 필수 | user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다. |
messages[].content | string / object[] | 필수 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
messages[].content[] | object | 조건부 | 이미지에는 type: image 콘텐츠 블록을 사용하고 데이터를 source에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다. |
system | string / object[] | 선택 | 시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다. |
max_tokens | integer | 필수 | 출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
temperature | number | 조건부 | 샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다. |
top_p | number | 조건부 | 누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요. |
tools | object[] | 조건부 | 모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다. |
tool_choice | object | 조건부 | 도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요. |
POST /v1/messages/count_tokens
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 glm-5.3-flash로 설정하세요. |
messages | object[] | 필수 | user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다. |
messages[].content | string / object[] | 필수 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
messages[].content[] | object | 조건부 | 이미지에는 type: image 콘텐츠 블록을 사용하고 데이터를 source에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다. |
system | string / object[] | 선택 | 시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다. |
tools | object[] | 조건부 | 입력 토큰 계산에 포함할 도구 정의입니다. 실제 Messages 요청과 같은 도구를 전달하세요. |
요청 예시
API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.
Chat Completions
bash
curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "glm-5.3-flash",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
],
"stream": false
}'
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "glm-5.3-flash",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
Count Tokens
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "glm-5.3-flash",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
응답 읽기
- Chat Completions ·
choices[].message.content에서 텍스트를 읽으세요. SSE 스트림에서는choices[].delta로 새 출력이 전송됩니다. JSON · SSE - Anthropic Messages ·
content[]에서 유형이text인 블록을 읽으세요. 스트리밍 시 SSE 콘텐츠 블록 이벤트를 순서대로 처리하세요. JSON · SSE - Count Tokens ·
input_tokens에서 입력 토큰 수를 읽으세요.
기능 및 제한
streaming· 지원tool_calling· 지원image_input· 지원video_input· 공개되지 않음
관련 가이드
Claude Code에서 GLM-5.3 사용하는 방법
Claude Code에서 GLM-5.3을 사용하도록 API 키, Base URL과 모델을 설정합니다. Windows·macOS·Linux 환경 변수를 확인하고 인증, 모델 선택 및 연결 오류를 해결하세요.
Chat Completions
OpenAI Chat 형식으로 대화를 보냅니다. 요청 전에 모델과 선택한 엔드포인트가 Chat을 지원하는지 확인하세요.
Anthropic Messages
Anthropic Messages 형식으로 HTTP 요청을 보냅니다. Claude Code 설정은 관련 가이드를 참고하세요.