> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT 전체 모델 인터페이스 - Responses 빠른 시작

> - OpenAI Responses 형식으로 GPT 시리즈 텍스트 모델을 호출합니다(구체적인 모델은 `model` 매개변수로 선택)
- 추론 + 도구 호출 모델로, 텍스트와 이미지 혼합 입력을 지원합니다
- 이 API는 서버 측 도구를 지원합니다: 웹 검색, 코드 실행, 문서 검색
- 여러 턴의 대화는 `previous_response_id`로 연결할 수 있어 히스토리를 다시 올릴 필요가 없습니다
- 💡 도구와 전체 매개변수가 필요하신가요? [전체 매개변수 문서](./responses-reference)를 확인하세요

<Note>
  **BaseURL**: 기본 BaseURL은 `https://direct.evolink.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.evolink.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.
</Note>


## OpenAPI

````yaml ko/api-manual/language-series/gpt/responses/responses-quickstart.json POST /v1/responses
openapi: 3.1.0
info:
  title: GPT 전체 모델 인터페이스 - Responses 빠른 시작
  description: >-
    OpenAI 호환 Responses API로 GPT 시리즈 텍스트 모델을 호출하기 위한 빠른 시작 예제입니다(서버 측 도구는 이
    API에서 제공됩니다).
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: 프로덕션 (권장)
  - url: https://api.evolink.ai
    description: 대체 URL
security:
  - bearerAuth: []
tags:
  - name: Responses
    description: 서버 측 도구를 지원하는 OpenAI Responses API
paths:
  /v1/responses:
    post:
      tags:
        - Responses
      summary: GPT 빠른 응답 (전체 모델)
      description: |-
        - OpenAI Responses 형식으로 GPT 시리즈 텍스트 모델을 호출합니다(구체적인 모델은 `model` 매개변수로 선택)
        - 추론 + 도구 호출 모델로, 텍스트와 이미지 혼합 입력을 지원합니다
        - 이 API는 서버 측 도구를 지원합니다: 웹 검색, 코드 실행, 문서 검색
        - 여러 턴의 대화는 `previous_response_id`로 연결할 수 있어 히스토리를 다시 올릴 필요가 없습니다
        - 💡 도구와 전체 매개변수가 필요하신가요? [전체 매개변수 문서](./responses-reference)를 확인하세요
      operationId: gptResponsesQuickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponsesQuickRequest'
      responses:
        '200':
          description: 응답 생성 성공
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesResponse'
        '400':
          description: 잘못된 요청 매개변수
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 400
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: 인증되지 않음, 유효하지 않거나 만료된 토큰
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 401
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: 할당량 부족
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 402
                  message: Insufficient quota
                  type: insufficient_quota_error
                  fallback_suggestion: https://evolink.ai/dashboard/billing
        '429':
          description: 요청 한도를 초과했습니다
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 429
                  message: Rate limit exceeded
                  type: rate_limit_error
                  fallback_suggestion: retry after 60 seconds
        '500':
          description: 서버 내부 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 500
                  message: Internal server error
                  type: internal_server_error
                  fallback_suggestion: try again later
        '503':
          description: 서비스 일시적으로 사용 불가
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 503
                  message: Service temporarily unavailable
                  type: service_unavailable_error
                  fallback_suggestion: retry after 30 seconds
components:
  schemas:
    ResponsesQuickRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: |-
            호출할 모델:

            | 모델 ID | 컨텍스트 윈도우 | 포지셔닝 |
            |---|---|---|
            | `gpt-5.6-sol` | 1,050,000 | GPT-5.6 제품군, 최첨단 추론 |
            | `gpt-5.6-terra` | 1,050,000 | GPT-5.6 제품군, 균형 잡힌 프로덕션 |
            | `gpt-5.6-luna` | 1,050,000 | GPT-5.6 제품군, 높은 처리량과 비용 관리 |
            | `gpt-5.5` | 400,000 | 범용 추론 모델 |
            | `gpt-5.4` | 128,000 | 범용 추론 모델 |
            | `gpt-5.2` | 400,000 | 범용 추론 모델 |
            | `gpt-5.1` | 400,000 | 범용 추론 모델 |
          enum:
            - gpt-5.6-sol
            - gpt-5.6-terra
            - gpt-5.6-luna
            - gpt-5.5
            - gpt-5.4
            - gpt-5.2
            - gpt-5.1
          example: gpt-5.6-sol
        input:
          description: |-
            모델 입력: 단순 문자열 또는 입력 항목 배열입니다.

            멀티모달과 도구 결과의 전체 작성 방법은 [전체 매개변수 문서](./responses-reference)를 참고하세요.

            ```json
            "input": [
              {
                "role": "user",
                "content": [
                  { "type": "input_text", "text": "이 이미지에는 무엇이 있나요?" },
                  { "type": "input_image", "image_url": "https://example.com/photo.png" }
                ]
              }
            ]
            ```
          oneOf:
            - type: string
            - type: array
              items:
                type: object
          example: Explain quantum entanglement in one sentence.
    ResponsesResponse:
      type: object
      properties:
        id:
          type: string
          description: 이번 응답의 고유 ID로, 다음 턴의 `previous_response_id`로 사용할 수 있습니다
          example: resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5
        object:
          type: string
          enum:
            - response
          description: 응답 유형
          example: response
        status:
          type: string
          description: 응답 상태
          enum:
            - completed
            - incomplete
            - failed
          example: completed
        model:
          type: string
          description: 실제 사용된 모델 이름
          example: gpt-5.6-sol
        created_at:
          type: integer
          description: 생성 타임스탬프
          example: 1786705221
        output:
          type: array
          description: >-
            생성 순서대로 정렬된 출력 항목: `reasoning` 항목(추론 요약), 도구 호출 항목, 그리고 마지막으로
            `output_text` 내용을 담은 `message` 항목.
          items:
            $ref: '#/components/schemas/OutputItem'
        usage:
          $ref: '#/components/schemas/Usage'
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
              description: HTTP 상태 오류 코드
            message:
              type: string
              description: 오류 설명
            type:
              type: string
              description: 오류 유형
            param:
              type: string
              description: 관련 매개변수 이름
            fallback_suggestion:
              type: string
              description: 오류 발생 시 제안
    OutputItem:
      type: object
      properties:
        id:
          type: string
          description: 출력 항목 식별자
        type:
          type: string
          description: 출력 항목 유형
          enum:
            - reasoning
            - message
            - web_search_call
            - code_interpreter_call
            - file_search_call
            - function_call
          example: message
        status:
          type: string
          description: 출력 항목 상태
          example: completed
        content:
          type: array
          description: 메시지 콘텐츠 파트(`output_text`). `message` 항목에 포함됩니다
          items:
            type: object
    Usage:
      type: object
      description: >-
        Token 사용량 통계입니다. Prompt 캐시는 자동으로 적용되며, 캐시에 적중한 입력 token은 더 저렴한 캐시 요금으로
        청구됩니다.
      properties:
        input_tokens:
          type: integer
          description: 입력 토큰 수
          example: 18
        output_tokens:
          type: integer
          description: 출력 토큰 수 (추론 토큰 포함)
          example: 42
        total_tokens:
          type: integer
          description: 총 토큰 수
          example: 60
        input_tokens_details:
          type: object
          description: 상세 입력 토큰 정보
          properties:
            cached_tokens:
              type: integer
              description: 캐시에 적중한 token 수
              example: 0
        output_tokens_details:
          type: object
          description: 상세 출력 토큰 정보
          properties:
            reasoning_tokens:
              type: integer
              description: 추론 토큰 수
              example: 16
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |-
        ##모든 API는 Bearer Token 인증이 필요합니다##

        **API Key 받기:**

        [API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요

        **요청 헤더에 추가:**
        ```
        Authorization: Bearer YOUR_API_KEY
        ```

````