GUIDE · K-EXAONE 2.5 무료 API 2026.11.20 확인

512K 컨텍스트,
지금은 무료.
지킬 조건은 3개.

LG AI연구원이 연 K-EXAONE 2.5 API입니다. OpenAI 호환이라 기존 코드에서 주소·키·모델명만 바꾸면 호출됩니다. 아래에 키 발급 화면, 복붙 코드, 그리고 붙이기 전에 읽어야 하는 약관 세 조항을 순서대로 뒀습니다. 문서와 약관 원문, 그리고 실제 호출로 확인한 것만 적었습니다.

모델
k-exaone_v2.5
컨텍스트
524,288 토큰
비용
현재 무료

01 · 키 발급 → 첫 호출

키만 받으면 첫 응답까지 5분입니다

문서는 호출 예시부터 시작하고 정작 키 받는 화면은 잘 안 보입니다. 화면에 적힌 이름 그대로 순서를 적었습니다.

  1. 01

    docs.exaone.ai에서 'API Key 발급하기'

    문서 오른쪽 위의 API Key 발급하기를 누르면 EXAONE ID 로그인으로 갑니다(Overview 화면 오른쪽 위에도 같은 버튼이 있습니다). 계정이 없으면 가입합니다. 만 19세 이상만 가입할 수 있고, 이메일 인증번호 6자리를 넣어야 합니다.

  2. 02

    My Profile → API Key → 'API Key 생성하기'

    키는 계정당 하나이고, 만든 순간에 한 번만 보입니다. 창을 닫기 전에 복사하세요. 놓쳤다면 기존 키를 삭제하고 새로 만들어야 합니다.

  3. 03

    환경변수에 넣기

    EXAONE_API_KEY로 보관하고 코드에서는 환경변수로 읽습니다. 키를 브라우저·앱 같은 클라이언트 코드에 넣으면 그대로 노출되므로, 운영에서는 서버를 거쳐 호출하라고 문서가 안내합니다.

  4. 04

    주소와 모델명만 맞춰서 호출

    POST https://api.exaone.ai/v1/chat/completions · 모델 k-exaone_v2.5. 아래 코드를 그대로 쓰면 됩니다.

모델 IDk-exaone_v2.5
엔드포인트POST https://api.exaone.ai/v1/chat/completions
호환성OpenAI Compatible API (chat completions)
컨텍스트524,288 토큰 — 입력 토큰과 max_tokens의 합이 이 값을 넘으면 400이 납니다
최대 출력512K (Models 문서 표기)
파라미터750B · 활성 31B
언어한국어 / 영어 (텍스트 전용)
학습 지식 기준2026-01
기능Chat · Tool calling · Structured outputs · Code generation · Streaming
비용현재 무료 — 무료 종료일·유료 요금은 미공개

출처: docs.exaone.ai의 K-EXAONE 2.5 문서·Models·Changelog, EXAONE API Platform 이용약관(2026-11-09 시행) — 2026-11-20 열람.

02 · 복붙 코드

기존 OpenAI 코드에서는 세 줄만 바꿉니다

바꾸는 곳은 base_url, api_key, model 셋입니다. 아래 코드는 2026-11-20에 그대로 실행해 200 응답과 답변 본문을 확인한 형태입니다.

first-call.sh bash
$ export EXAONE_API_KEY='발급받은_키'

$ curl https://api.exaone.ai/v1/chat/completions \
    -H "Authorization: Bearer $EXAONE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
      "model": "k-exaone_v2.5",
      "max_tokens": 512,
      "messages": [
        {"role": "user", "content": "한국어로 짧게 인사해 줘."}
      ],
      "reasoning_effort": "low",
      "temperature": 1.0,
      "top_p": 0.95
    }'
first_call.py python · requests
import os
import requests

url = "https://api.exaone.ai/v1/chat/completions"
headers = {
    "Authorization": f"Bearer {os.environ['EXAONE_API_KEY']}",
    "Content-Type": "application/json",
}
payload = {
    "model": "k-exaone_v2.5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "한국어로 짧게 인사해 줘."}],
    "reasoning_effort": "low",
    "temperature": 1.0,
    "top_p": 0.95,
    "stream": False,
}

r = requests.post(url, headers=headers, json=payload, timeout=120)
data = r.json()

print(data["choices"][0]["message"]["content"].strip())   # 답변 (앞뒤 공백 제거)
print(data["usage"])                                       # 프롬프트·완성·추론 토큰
first_call_sdk.py python · openai 3.57
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["EXAONE_API_KEY"],
    base_url="https://api.exaone.ai/v1",      # ← 주소만 바꿈
)

r = client.chat.completions.create(
    model="k-exaone_v2.5",                   # ← 모델명만 바꿈
    messages=[{"role": "user", "content": "한국어로 짧게 인사해 줘."}],
    max_tokens=512,
    reasoning_effort="low",
)
print(r.choices[0].message.content.strip())

여기서 한 번씩 걸립니다

  1. 01

    max_tokens에 추론 토큰이 포함됩니다

    이 모델은 항상 추론을 거친 뒤 답합니다. max_tokens를 64처럼 작게 잡으면 추론만 하다 끝나서 답변이 빈 문자열로 옵니다(low에서도 확인). 512부터 시작하세요.

  2. 02

    답변 앞에 줄바꿈이 붙습니다

    content 앞에 \n\n이 붙을 수 있습니다. 문자열을 비교하기 전에 .strip()을 쓰세요. 문서도 같은 이유로 공백 제거를 권합니다.

  3. 03

    추론은 따로 옵니다

    답은 message.content, 추론 과정은 message.reasoning_content, 추론 토큰 수는 usage.reasoning_tokens입니다. reasoning_effort 기본값은 max이고, 빠른 응답이 필요하면 low를 씁니다.

  4. 04

    401·429·400은 원인이 셋으로 갈립니다

    401은 대개 Authorization: Bearer 키 형식 누락이거나 30일 만료입니다. 429면 x-day-rate-limit·retry-after 헤더를 읽어 간격을 늘립니다. 400이면 입력 토큰과 max_tokens의 합이 524,288을 넘었는지 봅니다.

  5. 05

    스트리밍은 옵션 두 개

    stream: true로 받고, 마지막 청크에 사용량까지 받으려면 stream_options: {"include_usage": true}를 함께 넣습니다.

03 · 조건 3개

붙이기 전에 읽어야 하는 세 조항

보도자료는 "누구나 무료"라고 썼지만, 실제 범위는 같은 날 시행된 이용약관이 정합니다. 두 문서가 어긋나면 좁은 쪽을 따르는 게 안전합니다.

조건 01

비상업 목적만

약관 제2조 1항

"회사는 이용자에게 비독점적, 양도 불가능, 취소 가능한 비상업적 이용 권한을 부여합니다. 이용자는 AI 모델이나 결과물을 영리 목적으로 이용하거나, API를 이용자의 제품이나 서비스에 연동하는 등의 방법으로 제3자가 AI 모델을 호출하거나 AI 모델에 입력값을 입력하도록 할 수 없습니다."

EXAONE API Platform 이용약관 (2026-11-09 시행)

개인 공부·연구·프로토타입은 이 권한 안쪽입니다. 문제는 사내 문서 초안처럼 매출과 바로 이어지지 않는 쓰임인데, 약관에 '영리 목적'의 정의가 없어 판단이 갈립니다. 업무에 붙이기 전에 운영사([email protected])에 물어보고 답을 남겨두세요. 결과물을 파는 것, 내 서비스에 붙여 고객이 호출하게 하는 것, API를 재판매하는 것은 같은 조 1항과 5항에서 막습니다.

조건 02

키는 30일

약관 제3조 4항 · 5항

API 키의 유효기간은 발급일로부터 30일이고, 기간이 지난 키는 자동으로 비활성화됩니다. 90일 동안 로그인하지 않아도 비활성화될 수 있습니다. 만료되면 401이 나므로, 만료일을 캘린더에 걸어두고 만료 전에 새 키를 발급해 환경변수만 바꾸는 방식이 편합니다.

키는 계정당 하나입니다. 새로 만들면 그 키를 쓰던 곳(로컬 .env, 서버, CI 비밀 값, 에이전트 도구 설정)을 모두 바꿔야 합니다. 키를 남과 나눠 쓰는 것도 제3조 3항에서 금지이고, 그 키로 일어난 이용은 키 주인의 이용으로 봅니다.

조건 03

학습 이용은 선택 동의

개인정보 처리방침

입력값과 결과물의 모델 학습 이용은 선택 동의 항목입니다. 동의하지 않으면 입력값과 결과물은 요청 처리에만 쓰고 저장하지 않습니다. 동의한 경우 My profile > 동의 및 알림 관리에서 언제든 철회할 수 있지만, 철회 전에 이미 학습에 반영된 데이터는 분리해 삭제하기 어렵다고 방침에 적혀 있습니다. 동의하면 일일 호출 한도가 늘어나는데, 늘어나는 숫자는 공개되지 않았습니다.

그래서 고객 문의 원문, 연락처, 주민번호가 섞인 문서는 마스킹한 뒤 넣으세요. 타인의 개인정보가 포함된 입력값은 약관 제7조 8항에서 아예 금지합니다.

그 밖에 걸리는 것

  • 경쟁 모델 학습 금지 — 결과물을 모아 다른 모델을 학습시키는 실험은 약관 제4조 2항 g목과 맞닿습니다. 승인 없는 부하·보안 시험도 같은 항 j목에서 금지합니다.
  • 한도는 계정마다 다릅니다 — 문서 예시는 1초 1회·1분 60회·하루 86,400회지만, 실제 값은 계정마다 다릅니다. 내 계정 값은 응답 헤더 x-second/minute/day-rate-limit로 확인하세요.
  • 무료의 범위 — Changelog(2026-11-09)는 "현재 무료"라고만 적습니다. 종료일과 유료 요금은 공개되지 않았고, 약관 제9조는 모델 버전 변경·서비스 종료·유료 전환 시 요금을 홈페이지에 게시한다고 정합니다.
  • 결과물 책임은 이용자에게 — 제5조는 서비스를 있는 그대로 제공하고 정확성을 보장하지 않는다고 적습니다. 중요한 판단에 쓸 때는 원문 확인을 따로 하세요.

04 · 초대코드

제가 실제로 쓰는 세 개

피클·Muse·Cue 초대코드입니다. 혜택 문구는 각 서비스가 정한 그대로 옮겼고, 붙잡아 늘리지 않았습니다. 코드를 누르면 복사됩니다.

피클 Pickle

NNS68L6Y9CQJ

친구 초대 가입 완료 시 양쪽 모두 전체 초기화 티켓 지급

초대 링크 열기 ↗
Muse muse.ai

C31Q6T

가입 후 48시간 이내 설정에서 입력 시 양쪽 모두 Muse 토큰 10억 개 지급

가입 화면 열기 ↗
Cue cue.im

YR74M

초대코드 입력 시 Cue by Manus 얼리 액세스 가입 가능

사이트 열기 ↗

코드·혜택은 2026-11-20 기준입니다. 각 서비스가 조건을 바꾸거나 코드를 소진하면 이 페이지와 댓글 안내도 같이 고칩니다. Cue는 초대코드 입력이 아이폰 앱에서만 됩니다.

05 · 방법은 DM으로

화면에는 결과만,
순서는 DM으로

이 페이지를 소개하는 인스타 릴스는 7~10초입니다. 첫 프레임에 결과를 먼저 보여주고, 키 발급 화면 이름·자주 걸리는 401/429·약관 세 조항은 캡션에 몰아넣지 않고 댓글/DM으로 보냅니다. 긴 설명을 캡션에 넣으면 끝까지 읽는 사람이 없습니다.

06 · 자주 묻는 것

먼저 물어보실 것들

회사 업무에 써도 되나요?

약관이 주는 권한은 비상업적 이용입니다. 개인 공부·연구·프로토타입은 그 안쪽이지만, 사내 문서 초안이나 업무 자동화가 '영리'인지는 약관에 정의가 없어 판단이 갈립니다. 사업에 붙이기 전에는 운영사([email protected])에 물어보고 답을 남겨두세요. 사내 시험도 영리 활동으로 볼 여지가 있습니다.

무료는 언제까지인가요?

공개되지 않았습니다. Changelog는 2026-11-09에 "본 서비스는 현재 무료로 제공됩니다"라고만 적었고, 종료일·유료 요금은 어디에도 없습니다. 약관 제9조는 제공 종료나 유료 전환 시 요금을 홈페이지에 게시한다고 정합니다. 그래서 모델명·주소를 설정값으로 빼두고, 호출부를 한 파일에 모아두는 걸 권합니다.

하루에 몇 번까지 부를 수 있나요?

계정마다 다릅니다. 문서 예시는 1초 1회·1분 60회·하루 86,400회이고, 학습 이용에 동의하면 일일 한도가 늘어납니다(숫자 미공개). 내 계정의 실제 값은 응답 헤더 x-day-rate-limit와 x-day-rate-limit-remaining으로 확인하는 게 가장 정확합니다. 한도를 넘으면 429가 나고 retry-after가 함께 옵니다.

512K를 한 번에 다 넣을 수 있나요?

입력 토큰과 max_tokens의 합이 524,288을 넘으면 400이 납니다. 긴 문서를 넣을 때는 max_tokens를 함께 줄여 잡으세요. 답이 비어 나오면 대개 max_tokens가 추론 토큰에 다 쓰인 경우입니다.

키를 잃어버렸어요.

계정당 키가 하나라, 기존 키를 삭제하고 새로 만들어야 합니다. My Profile → API Key에서 삭제한 뒤 'API Key 생성하기'로 다시 발급하고, 그 키를 쓰던 곳(.env, 서버, CI, 에이전트 설정)을 모두 바꾸세요. 키는 만든 순간에 한 번만 보입니다.

이 페이지 정보는 언제 기준인가요?

2026-11-20입니다. docs.exaone.ai의 K-EXAONE 2.5·Models·Rate Limits·Changelog 문서, EXAONE API Platform 이용약관(2026-11-09 시행)과 개인정보 처리방침을 열람했고, 코드 세 개는 같은 날 실제로 호출해 응답을 확인했습니다. 문서가 바뀌면 이 페이지도 같이 고칩니다.