# GLM 5.2 API

Z.ai 기반 GLM 5.2 LLM 모델을 위한 전체 API 레퍼런스입니다.

## 모델 변형

이 API는 한 가지 모델 변형을 지원합니다:

| 모델 | ID | 설명 |
|-------|----|-------------|
| **GLM 5.2 Text to Text** | `glm-5.2-text-to-text` | 일반 텍스트 추론 및 작성 |

## 빠른 비교

| 기능 | Text to Text |
|---------|--------------|
| 텍스트 입력 | 필수 ✅ |
| 이미지 입력 | 지원 안 함 ❌ |
| 파일 입력 | 지원 안 함 ❌ |
| 스트리밍 응답 | SSE |
| `max_tokens` | 선택 사항 |
| `top_p` | 선택 사항 |
| `top_k` | 선택 사항 |

## GLM 5.2 Text to Text

### 엔드포인트

```http
POST /api/v1/chat/completions
```

### 요청 파라미터

#### 필수

| 파라미터 | 유형 | 설명 |
|-----------|------|-------------|
| `model` | string | `"glm-5.2-text-to-text"`여야 합니다 |
| `messages` | array | 순서가 있는 메시지. 메시지 구조는 LLM API를 참조하세요. |
| `stream` | boolean | SSE는 `true`, 단일 JSON 응답은 `false`입니다. |

#### 메시지 지원

| 필드 | 텍스트 | 파일 | 이미지 |
|-------|------|------|-------|
| `messages` | 필수 ✅ | 지원 안 함 ❌ | 지원 안 함 ❌ |

#### 선택 사항

| 파라미터 | 유형 | 범위 | 설명 |
|-----------|------|-------|-------------|
| `max_tokens` | integer | `> 0` | 최대 출력 토큰 수. |
| `top_p` | number | `0.0` - `1.0` | 후보 토큰의 누적 확률 질량을 제한합니다. |
| `top_k` | integer | `0` - `100` | 후보 토큰 수를 제한합니다. |

### 요청 예시

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'glm-5.2-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a four-line modern poem about a programmer drinking coffee.'
      }
    ],
    stream: true,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});
```

## 응답 형식

GLM 5.2는 OpenAI 호환 completion 응답을 반환합니다. `stream: true`이면 응답은 Server-Sent Events(SSE)이며, `stream: false`이면 단일 JSON 객체입니다.

## 모범 사례

- GLM 5.2는 현재 이 라우트에서 텍스트 전용 입력만 지원합니다.
- 출력 다양성을 더 엄격하게 제어해야 할 때 `top_p`와 `top_k`를 함께 사용하세요.
- 긴 형식의 콘텐츠나 코드를 생성할 때는 프롬프트를 구조화하세요.