KO ▾
API 키 받기

GLM 사용자용 빠른 시작

이 빠른 시작은 표준 호환 SDK를 사용하여 GLM API를 통합하는 방법을 안내합니다. 인증, 기본 완성, 스트리밍, 함수 호출을 다룹니다.

설치 및 구성

시작하려면 해당 언어의 공식 OpenAI SDK가 설치되어 있는지 확인하세요. API는 표준 헤더 기반 인증을 사용합니다. Authorization 헤더를 Bearer your-api-key로 설정하고 기본 URL을 https://api.glmapi.cc/v1로 구성하세요. 이 URL은 OpenAI Chat Completions 형식을 지원하는 모든 클라이언트에서 작동합니다.

표준 구성 외에 특수 클라이언트 초기화가 필요하지 않습니다. 이 서비스는 기존 OpenAI 통합의 대체재로 작동합니다. 사용 가능한 모델 엔드포인트를 확인하여 설정을 검증할 수 있습니다.

첫 번째 요청

연결성을 테스트하려면 간단한 텍스트 완성 요청을 보내세요. 주요 대형 언어 모델에는 모델 식별자 uncensored를 사용하세요. API는 max_tokens 및 temperature와 같은 표준 매개변수를 받습니다.

이 요청은 직접 텍스트 응답을 반환합니다. 401 오류가 발생하면 API 키를 확인하세요. 402 오류는 선불 크레딧이 부족함을 나타냅니다.

curl https://api.glmapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK 통합

공식 Python 라이브러리를 사용하여 API와 상호 작용하세요. 기본 URL과 API 키로 클라이언트를 초기화하세요. 구문은 표준 OpenAI 클라이언트 구조와 유사합니다.

이 방법은 비즈니스 로직을 다시 작성하지 않고 공급자를 교체할 수 있게 합니다. 모델은 표준 프롬프트 형식에 응답합니다. 표준 매개변수를 통해 출력 길이와 무작위성을 제어할 수 있습니다.

from openai import OpenAI

client = OpenAI(base_url="https://api.glmapi.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK 통합

JavaScript 환경에서는 Node SDK를 사용하세요. baseUrl을 우리 API 엔드포인트를 가리도록 구성하세요. 이렇게 하면 모든 요청이 서버로 올바르게 라우팅됩니다.

SDK는 재시도 및 응답 구문을 자동으로 처리합니다. 표준 완성 매개변수를 전달할 수 있습니다. 응답 객체는 예상된 위치에 생성된 텍스트를 포함합니다.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapi.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍 응답

stream 매개변수를 true로 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE)를 통해 청크를 반환합니다. 각 청크에는 부분 텍스트와 사용량 통계가 포함됩니다.

이 방법은 긴 응답에 대한 지각된 지연 시간을 줄입니다. 도착하는 대로 토큰을 처리할 수 있습니다. 마지막 청크에는 청구를 위한 총 토큰 수가 포함됩니다.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

제한, 오류 및 컨텍스트

컨텍스트 창은 총 100,000토큰을 지원하며 최대 출력은 32,000토큰입니다. 8 MB 본문 제한을 초과하는 요청은 실패합니다. 분당 300개 요청 및 키당 8개의 동시 요청으로 제한됩니다.

오류 401은 유효하지 않은 키를 의미합니다. 오류 402는 선불 크레딧이 남지 않았음을 나타냅니다. 오류 429는 속도 제한 상태임을 알립니다. 크레딧은 만료되지 않으며 오류는 토큰을 소비하지 않습니다. 프라이버시가 유지되며 프롬프트는 학습에 사용되지 않습니다.

기술 사양

크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.

항목내용
형식OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작
모델 IDuncensored
엔드포인트POST /v1/chat/completions · GET /v1/models
인증Authorization: Bearer YOUR_KEY
Base URLhttps://api.glmapi.cc/v1
파라미터temperature, top_p, stop, seed, presence_penalty, frequency_penalty
컨텍스트 창100,000 토큰 (입력 + 출력)
최대 출력100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음)
함수 호출지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송
스트리밍지원 — SSE, 마지막 청크에 토큰 사용량 포함
JSON 모드response_format: {"type": "json_object"}
동시 요청키당 동시 8개
요청 크기최대 8 MB
응답 헤더X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
속도 제한키당 분당 300회
충전USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액
유효기간유료 크레딧은 만료되지 않으며 구독 없음
보너스$50 이상 +5%, $100 이상 +10%, $200 이상 +15%
과금선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료
무료 체험$0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용
가격입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50
콘텐츠성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부
로그인Google 또는 이메일과 비밀번호
키계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효

오류 코드

오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.

코드유형의미
400bad_request잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과
401missing_key · invalid_key · key_revoked키 없음·잘못됨·새 키로 교체됨
402no_credit잔액 없음 — 충전하면 즉시 재개
403content_blocked미성년자 관련 성적 콘텐츠 — 거부, 과금 없음
404not_found알 수 없는 엔드포인트
413request_too_large본문 8 MB 초과
429rate_limited · concurrency분당 300회 또는 동시 8개 초과 — 잠시 후 재시도
503upstream_busy모델 혼잡 — 몇 초 후 재시도

질문과 답변

공식 GLM API인가요?

아니요, 독립적인 서비스입니다. 자체 무검열 모델을 운영하며 OpenAI 호환 인터페이스를 제공합니다. 기존 GLM 개발사와는 무관합니다.

API는 어떻게 결제하나요?

암호화폐(USDT(TRC20), USDC(Base))로 충전할 수 있습니다. 최소 충전 금액은 $20입니다. 선불 크레딧은 토큰 사용량에 따라 청구되며 만료되지 않습니다.

컨텍스트 창 크기는 얼마인가요?

이 모델은 100,000토큰의 컨텍스트 창을 지원합니다. 별도 지시가 없는 한 요청당 최대 출력은 32,000토큰입니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것뿐입니다.

API 키 받기문서 읽기