Chat Completions
OpenAI Chat Completions 형식의 API입니다. POST /v1/chat/completions로 호출합니다.
SDK는 pip install openai 또는 npm install openai 명령으로 설치합니다. 시스템 프롬프트는 messages 배열의 첫 번째 항목에 role: "system"으로 지정하며, 모델의 역할과 말투, 응답 규칙을 정의할 때 사용합니다.
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": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
}'생성된 답변은 message.content에, 모델의 추론 내용은 message.reasoning에 별도로 반환됩니다.
finish_reason은 생성이 종료된 사유를 나타내며, 값은 다음과 같습니다.
| 값 | 설명 |
|---|---|
stop | 답변 생성 완료 |
tool_calls | 모델의 도구 호출 요청 |
length | max_tokens 도달 |
추론 토큰도 max_tokens에 포함되므로, 값이 너무 작으면 답변이 비어 있을 수 있습니다. 자세한 내용은 추론을 참고하세요.
멀티턴 대화
Raon은 대화 내용을 서버에 저장하지 않습니다. 요청할 때마다 이전 대화 전체를 messages에 포함하고, 모델의 답변은 assistant 메시지로 추가하세요. 추론 내용은 대화 기록에 포함하지 않아도 됩니다.