Chat Completions
The OpenAI Chat Completions format, at POST /v1/chat/completions.
Install the SDK with pip install openai or npm install openai. The system prompt is the first item of messages, with role: "system"; it sets the model's role, tone and rules.
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!"}
]
}'The answer is in message.content. The model's reasoning comes separately in message.reasoning.
finish_reason says why the answer ended: stop when it is complete, tool_calls when the model wants a tool, and length when it reached max_tokens. Reasoning counts toward that limit, so a low max_tokens can leave the answer empty; see Reasoning.
Conversations
Raon keeps no conversation on the server. Send the whole conversation in messages on every turn, and append each answer as an assistant message. Leave the reasoning out of the history; the model does not need it back.
Related
- Streaming, structured outputs, web search and tool calling on this API.
- Every parameter is in the API reference.

