시작하기
API 키를 발급받고 Raon에 첫 요청을 보냅니다.
Raon은 raon-1-mini-preview 모델을 널리 사용되는 세 가지 API 형식으로 제공합니다. OpenAI·Anthropic SDK나 Raon과 호환되는 코딩 에이전트에서 Base URL, API 키, 모델 ID를 설정해 텍스트 생성 기능을 사용할 수 있습니다. 다른 API 서비스를 사용하던 코드를 Raon에 연결할 때는 지원 기능과 제한을 확인하세요.
이번 프리뷰의 모델 이용 요금은 0원입니다. 토큰 사용량은 계속 집계하며, 속도 제한도 적용합니다.
Base URL
모든 API 요청은 다음 주소로 보냅니다.
https://raon-api.krafton.aiAPI 키 발급
콘솔의 API 키 화면에서 API 키를 발급합니다. API 키는 코드에 직접 작성하지 말고 환경 변수로 관리하세요.
export RAON_API_KEY="<your key>"API 키는 Authorization: Bearer <key> 헤더에 담아 보냅니다. Messages API는 Anthropic SDK가 사용하는 x-api-key 헤더도 지원합니다.
첫 요청 보내기
curl https://raon-api.krafton.ai/v1/chat/completions \
-H "Authorization: Bearer $RAON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "raon-1-mini-preview", "messages": [{"role": "user", "content": "Hello!"}]}'curl 예제는 macOS·Linux 셸 기준입니다. Windows에서는 WSL이나 Git Bash에서 실행하거나 Python, TypeScript 예제를 사용하세요.
API 형식
사용하는 클라이언트와 같은 형식의 API를 호출하세요. API 간 요청 형식은 변환되지 않습니다. 클라이언트별 연결 방법은 SDK와 프레임워크를 참고하세요.
| 엔드포인트 | API 형식 | 사용 클라이언트 |
|---|---|---|
POST /v1/chat/completions | OpenAI Chat Completions | OpenClaw, Hermes, 기타 호환 도구 |
POST /v1/responses | OpenAI Responses | Codex |
POST /v1/messages | Anthropic Messages | Claude Code |
GET /v1/models는 API 키로 사용할 수 있는 모델 목록을 컨텍스트 윈도우, 요금 정보와 함께 반환합니다.
curl https://raon-api.krafton.ai/v1/models \
-H "Authorization: Bearer $RAON_API_KEY"AI 에이전트용 문서
이 문서는 AI 에이전트가 읽을 수 있도록 llms.txt 형식으로도 제공됩니다. 코딩 에이전트에게 Raon 연동 작업을 맡길 때는 먼저 llms.txt를 읽도록 지시하세요.
https://raon-mini.krafton.ai/ko/llms.txt 와 연결된 문서를 읽고, 이 앱에 Chat Completions API로 Raon을 연동해 줘.| 주소 | 내용 |
|---|---|
/ko/llms.txt | 전체 페이지의 Markdown 링크 목차 (영문: /llms.txt) |
/ko/llms-full.txt | 전체 페이지를 하나로 합친 파일 |
/openapi.yaml | OpenAPI 명세 (전체 엔드포인트, 파라미터, 거부 조건, 오류 형식) |
각 페이지 주소 끝에 .md를 붙이면 Markdown 문서를 볼 수 있습니다. 페이지 상단의 Markdown 복사 버튼으로 내용을 복사해 대화창에 붙여 넣을 수도 있습니다.