이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기

Response 생성

문서에 근거한 AI 응답을 생성합니다. 지정한 벡터 스토어에서 관련 청크를 검색하여 LLM의 컨텍스트로 사용합니다(검색 증강 생성).

POST

/responses

인증

`Authorization`
필수
Bearer <token>

위치: header

요청 본문

application/json필수

`model`string

응답 생성에 사용할 모델입니다.

기본값: "solar-pro4"

`input`
필수
string | array<object>

사용자의 질문 또는 입력입니다.

`tools`
필수
array<object>

도구 목록입니다. RAG에는 file_search 유형을 사용하세요.

`stream`boolean

실시간 응답을 위한 스트리밍을 활성화합니다.

기본값: false

`instructions`string

LLM의 동작을 설정하는 시스템 지침입니다.

예시

비스트리밍 요청

curl -X POST https://api.upstage.ai/v2/responses \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "solar-pro4",
    "input": "What are the key features?",
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123def456"],
        "max_num_results": 5
      }
    ]
  }'

비스트리밍 응답

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1711645000,
  "model": "solar-pro4",
  "output": [
    {
      "type": "file_search_call",
      "id": "fs_call_001",
      "status": "completed",
      "queries": ["What are the key features?"],
      "results": [
        {
          "file_id": "file_xyz789",
          "filename": "features.pdf",
          "text": "The key features include...",
          "score": 0.95,
          "attributes": {}
        }
      ]
    },
    {
      "type": "message",
      "id": "msg_001",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Based on the documents, the key features are...",
          "annotations": []
        }
      ]
    }
  ]
}

스트리밍 요청

Server-Sent Events(SSE)를 실시간으로 받으려면 stream=True를 설정하세요.

curl -X POST https://api.upstage.ai/v2/responses \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "solar-pro4",
    "input": "Summarize the document.",
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123def456"]
      }
    ],
    "stream": true
  }'

SSE 이벤트 유형

이벤트	설명
`response.created`	응답 객체가 생성되었습니다.
`file_search_call.searching`	파일 검색이 진행 중입니다.
`file_search_call.completed`	파일 검색이 완료되었으며 결과를 반환합니다.
`output_text.delta`	LLM이 순차적으로 생성하는 텍스트 청크입니다.
`output_text.done`	LLM의 텍스트 생성이 완료되었습니다.
`response.completed`	전체 응답이 완료되었습니다.
`[DONE]`	스트림의 종료를 나타내는 마지막 신호입니다.

이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기

Response 생성

문서에 근거한 AI 응답을 생성합니다. 지정한 벡터 스토어에서 관련 청크를 검색하여 LLM의 컨텍스트로 사용합니다(검색 증강 생성).

POST

/responses

인증

`Authorization`
필수
Bearer <token>

위치: header

요청 본문

application/json필수

`model`string

응답 생성에 사용할 모델입니다.

기본값: "solar-pro4"

`input`
필수
string | array<object>

사용자의 질문 또는 입력입니다.

`tools`
필수
array<object>

도구 목록입니다. RAG에는 file_search 유형을 사용하세요.

`stream`boolean

실시간 응답을 위한 스트리밍을 활성화합니다.

기본값: false

`instructions`string

LLM의 동작을 설정하는 시스템 지침입니다.

예시

비스트리밍 요청

curl -X POST https://api.upstage.ai/v2/responses \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "solar-pro4",
    "input": "What are the key features?",
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123def456"],
        "max_num_results": 5
      }
    ]
  }'

비스트리밍 응답

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1711645000,
  "model": "solar-pro4",
  "output": [
    {
      "type": "file_search_call",
      "id": "fs_call_001",
      "status": "completed",
      "queries": ["What are the key features?"],
      "results": [
        {
          "file_id": "file_xyz789",
          "filename": "features.pdf",
          "text": "The key features include...",
          "score": 0.95,
          "attributes": {}
        }
      ]
    },
    {
      "type": "message",
      "id": "msg_001",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Based on the documents, the key features are...",
          "annotations": []
        }
      ]
    }
  ]
}

스트리밍 요청

Server-Sent Events(SSE)를 실시간으로 받으려면 stream=True를 설정하세요.

curl -X POST https://api.upstage.ai/v2/responses \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "solar-pro4",
    "input": "Summarize the document.",
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123def456"]
      }
    ],
    "stream": true
  }'

SSE 이벤트 유형

이벤트	설명
`response.created`	응답 객체가 생성되었습니다.
`file_search_call.searching`	파일 검색이 진행 중입니다.
`file_search_call.completed`	파일 검색이 완료되었으며 결과를 반환합니다.
`output_text.delta`	LLM이 순차적으로 생성하는 텍스트 청크입니다.
`output_text.done`	LLM의 텍스트 생성이 완료되었습니다.
`response.completed`	전체 응답이 완료되었습니다.
`[DONE]`	스트림의 종료를 나타내는 마지막 신호입니다.

Response 생성

인증

`Authorization`
필수
Bearer <token>

요청 본문

`model`string

`input`
필수
string | array<object>

`tools`
필수
array<object>

`stream`boolean

`instructions`string

예시

비스트리밍 요청

비스트리밍 응답

스트리밍 요청

SSE 이벤트 유형

이 페이지에서

Response 생성

인증

`Authorization`
필수
Bearer <token>

요청 본문

`model`string

`input`
필수
string | array<object>

`tools`
필수
array<object>

`stream`boolean

`instructions`string

예시

비스트리밍 요청

비스트리밍 응답

스트리밍 요청

SSE 이벤트 유형

이 페이지에서

본문

Authorization필수Bearer <token>

modelstring

input필수string | array<object>

객체 1

tools필수array<object>

객체 1

streamboolean

instructionsstring

응답

이 페이지에서

본문

Authorization필수Bearer <token>

modelstring

input필수string | array<object>

객체 1

tools필수array<object>

객체 1

streamboolean

instructionsstring

응답

이 페이지에서

`Authorization`
필수
Bearer <token>

`model`string

`input`
필수
string | array<object>

`tools`
필수
array<object>

`stream`boolean

`instructions`string

`Authorization`
필수
Bearer <token>

`model`string

`input`
필수
string | array<object>

`tools`
필수
array<object>

`stream`boolean

`instructions`string