Raon
EN
KOEN
문서콘솔모델 체험하기
문서
Responses

응답 생성

POST
/v1/responses

OpenAI 호환 Responses 응답을 생성합니다. 대화 상태는 서버에 저장하지 않으며, store는 항상 false로 설정합니다. Raon 서버에서 웹 검색을 실행할 수 있지만 OpenAI 서비스의 저장 기능이나 그 밖의 서버 실행 도구는 사용할 수 없습니다.

인증

bearerAuth
header인증Bearer <token>

Raon API 키입니다. Authorization과 x-api-key 헤더를 모두 전송하면 Authorization: Bearer <key>의 값을 우선 사용합니다.

요청 본문

application/json
  1. body

대화 상태를 서버에 저장하지 않는 Responses 요청입니다. 대화 이력은 각 요청에 모두 포함하세요. 다음 입력은 HTTP 400으로 거부합니다.

  • 비어 있지 않은 previous_response_id, conversation, prompt
  • background: true
  • 저장된 항목을 참조하는 item_reference
  • 업로드된 파일을 참조하는 file_id

지원하지 않는 도구는 선언할 수 없습니다. additional_tools와 tool_search_output 입력 항목 안에 선언한 도구에도 같은 제한이 적용됩니다.

model*string

모델 목록에 표시되는 공개 모델 ID입니다.

길이1 <= length
input*|array<||||||||>
instructions?|null
stream?boolean

Responses API의 SSE 이벤트를 반환합니다.

기본값false
max_output_tokens?integer

추론을 포함한 최대 출력 토큰 수입니다.

범위1 <= value
temperature?|

샘플링 온도입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 temperature=1.0 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

범위0 <= value <= 2
top_p?|

누적 확률로 다음 토큰의 후보 범위를 제한하는 top-p 샘플링 값입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 top_p=0.95 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

범위0 <= value <= 1
top_k?|

다음 토큰을 선택할 때 고려하는 상위 후보 수입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 top_k=20 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

min_p?|

확률이 가장 높은 토큰을 기준으로 한 후보 토큰의 최소 상대 확률입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 min_p=0 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

presence_penalty?|

이미 등장한 토큰에 적용하는 페널티입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 presence_penalty=1.5 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

frequency_penalty?|

토큰의 등장 횟수에 따라 적용하는 페널티입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 frequency_penalty=0 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

repetition_penalty?|

토큰 반복에 적용하는 페널티입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 repetition_penalty=1.0 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

tools?array<||||>
tool_choice?||
parallel_tool_calls?boolean
text?
reasoning?

Raon은 추론 강도 설정을 무시하고 추론을 항상 활성화합니다. 그 외 추론 설정은 모델 서버에 전달합니다.

chat_template_kwargs?

모델 서버의 템플릿 설정입니다. Raon은 세 추론 API 모두에서 추론을 항상 활성화합니다.

store?boolean

생략한 경우를 포함해 항상 false로 설정합니다. 저장된 응답을 조회하는 기능은 제공하지 않습니다.

기본값false
background?boolean

요청을 처리한 결과를 같은 연결에서 반환하는 방식만 지원합니다. 백그라운드 실행을 요청하는 true를 지정하면 HTTP 400으로 거부합니다.

include?array<string>

응답에 추가로 포함할 항목을 지정합니다. 예를 들어 reasoning.encrypted_content로 암호화된 추론 데이터를 요청할 수 있습니다. Raon 서버에서 검색을 실행하는 경우에는 web_search_call.* 항목을 제외한 뒤 모델 서버에 전달하며, reasoning.encrypted_content를 요청 목록에 포함합니다.

metadata?

호출자가 지정한 메타데이터를 모델 서버에 전달합니다. 이 필드로 응답 저장 기능을 활성화할 수는 없습니다.

user?string

모델 서버에 전달할 호출자 식별자입니다.

truncation?string
허용 값"auto""disabled"

응답 본문

생성 결과를 JSON으로 반환합니다. stream이 true이면 서버 전송 이벤트(SSE)로 반환합니다. 응답에는 모델 서버의 추가 필드가 포함될 수 있습니다.

  1. response

모델 서버의 JSON 응답입니다. 모델 서버의 추가 필드가 포함될 수 있습니다. Raon 서버에서 검색을 실행하면 web_search_call 항목과 호출자가 지정한 도구 목록을 반환하며, 사용량은 마지막 내부 모델 호출 기준으로 보고합니다. 그 호출에는 대화 전체와 모든 검색 결과가 이미 담겨 있습니다.

id*string
object*string
created_at*number

초 단위 Unix 타임스탬프입니다.

status?string
허용 값"completed""failed""in_progress""cancelled""queued""incomplete"
model*string

모델 서버가 반환한 모델 ID이며, 게이트웨이는 이 값을 그대로 전달합니다. 요청에 지정한 공개 모델 ID와 다를 수 있습니다. 다음 요청에는 GET /v1/models에서 조회한 ID를 사용하세요.

길이1 <= length
output*array<|||||>
usage?|null
error?|null
incomplete_details?|null
instructions?string|null
max_output_tokens?integer|null
tools?array<||||>
tool_choice?||
parallel_tool_calls?boolean
store?boolean
temperature?|

샘플링 온도입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 temperature=1.0 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

top_p?|

누적 확률로 다음 토큰의 후보 범위를 제한하는 top-p 샘플링 값입니다. Raon 모델은 요청값, null, 생략 여부와 관계없이 항상 top_p=0.95 설정으로 생성합니다. 다른 제공자의 모델은 각 제공자의 파라미터 동작을 따릅니다.

text?
reasoning?|null
metadata?

호출자가 지정한 메타데이터를 모델 서버에 전달합니다. 이 필드로 응답 저장 기능을 활성화할 수는 없습니다.

curl -X POST 'https://raon-api.krafton.ai/v1/responses' \  -H 'Content-Type: application/json' \  -d '{  "model": "raon-1-mini",  "input": "Explain why the sky is blue.",  "max_output_tokens": 1024,  "store": false}'
응답 예시
{  "id": "string",  "object": "response",  "created_at": 0,  "status": "completed",  "model": "raon",  "output": [    {      "type": "message",      "id": "string",      "status": "in_progress",      "role": "assistant",      "content": [        {          "type": "output_text",          "text": "string",          "annotations": [            {              "type": "url_citation",              "start_index": 0,              "end_index": 0,              "url": "string",              "title": "string"            }          ],          "logprobs": [            {}          ]        }      ]    }  ],  "usage": {    "input_tokens": 0,    "output_tokens": 0,    "total_tokens": 0,    "input_tokens_details": {      "cached_tokens": 0    },    "output_tokens_details": {      "reasoning_tokens": 0    }  },  "error": {    "code": "string",    "message": "string"  },  "incomplete_details": {    "reason": "string"  },  "instructions": "string",  "max_output_tokens": 0,  "tools": [    {      "type": "function",      "name": "string",      "description": "string",      "parameters": {},      "strict": true    }  ],  "tool_choice": "none",  "parallel_tool_calls": true,  "store": false,  "temperature": 0,  "top_p": 0,  "text": {    "format": {      "type": "text"    }  },  "reasoning": {    "effort": "none",    "summary": "auto"  },  "metadata": {    "property1": "string",    "property2": "string"  }}

채팅 응답 생성 POST

OpenAI 호환 채팅 응답을 생성합니다. Raon 서버에서 웹 검색을 실행할 수 있으며, 응답은 저장하지 않습니다. 스트리밍 응답에 사용량을 포함하려면 `stream_options.include_usage`를 `true`로 설정하세요.

메시지 생성 POST

Anthropic 호환 메시지를 생성합니다. Raon 서버에서 실행하는 검색과 클라이언트에서 실행하는 도구를 지원합니다. 특정 도구를 이름으로 지정해 사용하도록 강제하는 기능은 지원하지 않습니다. Anthropic 서비스의 파일·컨테이너 기능과 그 밖의 서버 실행 도구도 사용할 수 없습니다.