> ## 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.

# Qwen3.8-Max-Preview - Responses API

> > 🚧 **이 모델은 아직 제공되지 않습니다. 기대해 주세요**

- OpenAI Responses 프로토콜로 Qwen3.8-Max-Preview 호출
- **유연한 입력**: `input`에 문자열을 전달할 수 있으며, Chat 형식의 메시지 배열도 전달 가능(멀티모달 `input_text` / `input_image` 지원)
- **멀티턴 대화**: `previous_response_id`를 전달해 이전 턴 응답을 연결하면, 서버가 컨텍스트를 자동으로 구성(응답 `id` 유효 기간 7일)
- **세션 캐시**: 요청 헤더에 `x-dashscope-session-cache: enable`(기본값 disable)을 추가해 활성화하며, 적중은 `usage.input_tokens_details.cached_tokens` 참조
- **사고 강도**: `reasoning.effort`로 제어
- **스트리밍 출력**: `stream=true`일 때 Responses 이벤트(`response.output_text.delta` / `response.completed` 등)로 반환

<Note>
  **BaseURL 설명**: 기본 BaseURL은 `https://direct.evolink.ai`이며, 텍스트 모델을 더 잘 지원하고 장기 연결을 지원합니다; `https://api.evolink.ai`는 멀티모달 주력 주소로, 이미지 입력을 포함할 때 이 주소를 사용하세요.

  **세션 캐시**: Responses API는 요청 헤더 `x-dashscope-session-cache: enable`로 서버 측 세션 캐시를 활성화하여 멀티턴 지연과 비용을 절감합니다.
</Note>


## OpenAPI

````yaml ko/api-manual/language-series/qwen3.8-max-preview/qwen3.8-max-preview-responses.json POST /v1/responses
openapi: 3.1.0
info:
  title: Qwen3.8-Max-Preview - Responses API
  description: >-
    Qwen3.8-Max-Preview의 OpenAI Responses 호환 API(`/v1/responses`).


    **Chat Completions 대비 장점**:

    - **컨텍스트 관리 간소화**: `previous_response_id`로 이전 턴을 연결하여, 전체 이력을 수동으로 이어 붙일 필요가
    없음

    - **내장 도구**: 웹 검색, 웹 페이지 추출, 코드 인터프리터 등

    - **간편한 세션 캐시**: 요청 헤더에 `x-dashscope-session-cache: enable`을 추가하면 서버가 대화
    컨텍스트를 자동 캐시하여 멀티턴 지연과 비용을 절감


    **능력**: 멀티모달 입력(텍스트 + 이미지), 사고 강도 제어(`reasoning.effort`), 스트리밍 출력.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: 프로덕션 환경(권장, 텍스트 모델 장기 연결 지원이 더 우수)
  - url: https://api.evolink.ai
    description: 멀티모달 주력 주소(이미지 입력 포함 시 사용)
security:
  - bearerAuth: []
tags: []
paths:
  /v1/responses:
    post:
      summary: Qwen3.8-Max-Preview Responses API(OpenAI 호환)
      description: >-
        > 🚧 **이 모델은 아직 제공되지 않습니다. 기대해 주세요**


        - OpenAI Responses 프로토콜로 Qwen3.8-Max-Preview 호출

        - **유연한 입력**: `input`에 문자열을 전달할 수 있으며, Chat 형식의 메시지 배열도 전달 가능(멀티모달
        `input_text` / `input_image` 지원)

        - **멀티턴 대화**: `previous_response_id`를 전달해 이전 턴 응답을 연결하면, 서버가 컨텍스트를 자동으로
        구성(응답 `id` 유효 기간 7일)

        - **세션 캐시**: 요청 헤더에 `x-dashscope-session-cache: enable`(기본값 disable)을
        추가해 활성화하며, 적중은 `usage.input_tokens_details.cached_tokens` 참조

        - **사고 강도**: `reasoning.effort`로 제어

        - **스트리밍 출력**: `stream=true`일 때 Responses
        이벤트(`response.output_text.delta` / `response.completed` 등)로 반환
      operationId: createResponseQwen38MaxPreview
      parameters:
        - name: x-dashscope-session-cache
          in: header
          required: false
          schema:
            type: string
            enum:
              - enable
              - disable
            default: disable
          description: 세션 캐시 스위치. `enable`로 설정하면 서버가 대화 컨텍스트를 자동 캐시하여 멀티턴 추론 지연과 비용을 절감합니다.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponseRequest'
            examples:
              basic:
                summary: 기본 호출(문자열 입력)
                value:
                  model: qwen3.8-max-preview
                  input: 무엇을 할 수 있나요?
              multi_turn:
                summary: 멀티턴 대화(previous_response_id)
                value:
                  model: qwen3.8-max-preview
                  input: GBDT와 어떤 차이가 있나요?
                  previous_response_id: resp_xxxxxxxx
              multimodal:
                summary: 멀티모달 입력(이미지)
                value:
                  model: qwen3.8-max-preview
                  input:
                    - role: user
                      content:
                        - type: input_text
                          text: 이 이미지를 설명해 주세요
                        - type: input_image
                          image_url: https://example.com/image.jpg
      responses:
        '200':
          description: 생성 성공
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseObject'
        '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 credits
                  type: insufficient_quota
        '429':
          description: 요청이 너무 잦음(속도 제한)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: 서버 내부 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ResponseRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          enum:
            - qwen3.8-max-preview
          example: qwen3.8-max-preview
          description: 대화 모델 이름
        input:
          description: >-
            모델 입력. 문자열(순수 텍스트)을 전달할 수 있으며, Chat 형식의 메시지 배열도 전달 가능(멀티모달
            `input_text` / `input_image` 지원).
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/InputItem'
        instructions:
          type: string
          description: >-
            시스템 지시로 컨텍스트 시작 위치에 삽입됩니다. `previous_response_id`를 사용할 때, 이전 턴의
            `instructions`는 이번 턴에 전달되지 않습니다.
        previous_response_id:
          type: string
          description: >-
            이전 턴 응답의 고유 ID(응답 `id`, 유효 기간 7일). 멀티턴 대화를 연결하는 데 사용하며, 서버가 해당 턴의
            입력과 출력을 자동으로 검색·구성하여 컨텍스트로 사용합니다.
        max_output_tokens:
          type: integer
          description: 이번 생성 출력 콘텐츠의 최대 token 수(사고 포함).
        reasoning:
          type: object
          description: 사고 제어.
          properties:
            effort:
              type: string
              enum:
                - low
                - medium
                - high
              description: 사고 강도
        store:
          type: boolean
          description: |-
            이번 응답을 저장할지 여부.

            - `true`(기본값): `previous_response_id`로 참조 가능
            - `false`: 저장하지 않으며, 이후 참조할 수 없음
          default: true
        stream:
          type: boolean
          description: Responses 이벤트로 스트리밍 반환할지 여부.
          default: false
        temperature:
          type: number
          description: 샘플링 온도, 범위 `[0, 2]`.
          minimum: 0
          maximum: 2
        top_p:
          type: number
          description: 뉴클리어스 샘플링 매개변수, 범위 `(0, 1]`.
          minimum: 0
          maximum: 1
        tools:
          type: array
          description: >-
            도구 목록. 내장 도구(`web_search` 웹 검색, `web_extractor` 웹 페이지 추출,
            `code_interpreter` 코드 인터프리터)와 사용자 정의 `function`을 지원합니다.
          items:
            $ref: '#/components/schemas/Tool'
    ResponseObject:
      type: object
      properties:
        id:
          type: string
          description: 이번 응답의 고유 ID(유효 기간 7일, `previous_response_id`로 사용 가능)
          example: resp_xxxxxxxx
        object:
          type: string
          example: response
        status:
          type: string
          description: 응답 상태
          example: completed
        model:
          type: string
          example: qwen3.8-max-preview
        output:
          type: array
          description: 출력 항목 배열(`message` / `reasoning` / 내장 도구 호출 등 포함)
          items:
            type: object
        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: 관련 매개변수 이름
    InputItem:
      type: object
      description: 입력 메시지 항목(Chat 형식).
      properties:
        role:
          type: string
          enum:
            - user
            - assistant
            - system
          description: 메시지 역할
        content:
          description: 메시지 내용. 순수 텍스트는 문자열로 전달하며, 멀티모달일 때는 내용 조각 배열로 전달합니다.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/InputContentPart'
    Tool:
      type: object
      description: >-
        도구 정의. 내장 도구는 `type`만 선언하면 되며, 사용자 정의 function은 이름과 매개변수 schema를 제공해야
        합니다.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - web_search
            - web_extractor
            - code_interpreter
            - function
          description: 도구 유형
        name:
          type: string
          description: '`type=function`일 때의 함수 이름'
        parameters:
          type: object
          description: '`type=function`일 때의 매개변수 JSON Schema'
    Usage:
      type: object
      description: token 사용 통계.
      properties:
        input_tokens:
          type: integer
          description: 입력 token 수
          example: 45
        output_tokens:
          type: integer
          description: 출력 token 수(사고 포함)
          example: 63
        total_tokens:
          type: integer
          description: 총 token 수
          example: 108
        input_tokens_details:
          type: object
          description: 입력 token 세부 항목
          properties:
            cached_tokens:
              type: integer
              description: 세션 캐시에 적중한 입력 token 수(캐시 읽기)
              example: 0
        output_tokens_details:
          type: object
          description: 출력 token 세부 항목
          properties:
            reasoning_tokens:
              type: integer
              description: 사고 과정 token 수
              example: 0
        prompt_tokens_details:
          type: object
          description: 세션 캐시 활성화 후 반환되는 캐시 세부 정보
          properties:
            cached_tokens:
              type: integer
              description: 캐시에 적중한 token 수
              example: 0
            cache_creation_input_tokens:
              type: integer
              description: 이번에 새로 생성된 캐시 token 수(캐시 쓰기)
              example: 0
    InputContentPart:
      type: object
      description: Responses 입력 내용 조각, `type`으로 유형을 선언합니다.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - input_text
            - input_image
          description: |-
            콘텐츠 유형

            - `input_text`: 텍스트
            - `input_image`: 이미지
        text:
          type: string
          description: '`type=input_text`일 때의 텍스트 내용'
        image_url:
          type: string
          description: '`type=input_image`일 때의 이미지 URL, 또는 `data:`로 시작하는 base64 data URL'
  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
        ```

````