LG AI연구원이 연 K-EXAONE 2.5 API입니다. OpenAI 호환이라 기존 코드에서 주소·키·모델명만 바꾸면 호출됩니다. 아래에 키 발급 화면, 복붙 코드, 그리고 붙이기 전에 읽어야 하는 약관 세 조항을 순서대로 뒀습니다. 문서와 약관 원문, 그리고 실제 호출로 확인한 것만 적었습니다.
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())
여기서 한 번씩 걸립니다
01
max_tokens에 추론 토큰이 포함됩니다
이 모델은 항상 추론을 거친 뒤 답합니다. max_tokens를 64처럼 작게 잡으면 추론만 하다 끝나서 답변이 빈 문자열로 옵니다(low에서도 확인). 512부터 시작하세요.
02
답변 앞에 줄바꿈이 붙습니다
content 앞에 \n\n이 붙을 수 있습니다. 문자열을 비교하기 전에 .strip()을 쓰세요. 문서도 같은 이유로 공백 제거를 권합니다.
03
추론은 따로 옵니다
답은 message.content, 추론 과정은 message.reasoning_content, 추론 토큰 수는 usage.reasoning_tokens입니다. reasoning_effort 기본값은 max이고, 빠른 응답이 필요하면 low를 씁니다.
04
401·429·400은 원인이 셋으로 갈립니다
401은 대개 Authorization: Bearer 키 형식 누락이거나 30일 만료입니다. 429면 x-day-rate-limit·retry-after 헤더를 읽어 간격을 늘립니다. 400이면 입력 토큰과 max_tokens의 합이 524,288을 넘었는지 봅니다.
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 초대코드입니다. 혜택 문구는 각 서비스가 정한 그대로 옮겼고, 붙잡아 늘리지 않았습니다. 코드를 누르면 복사됩니다.
약관이 주는 권한은 비상업적 이용입니다. 개인 공부·연구·프로토타입은 그 안쪽이지만, 사내 문서 초안이나 업무 자동화가 '영리'인지는 약관에 정의가 없어 판단이 갈립니다. 사업에 붙이기 전에는 운영사([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 시행)과 개인정보 처리방침을 열람했고, 코드 세 개는 같은 날 실제로 호출해 응답을 확인했습니다. 문서가 바뀌면 이 페이지도 같이 고칩니다.