> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Magnific으로 이미지 업스케일링

> 이 비동기 엔드포인트는 고급 AI 알고리즘을 사용하여 이미지 업스케일링을 가능하게 합니다.
제출 시 고유한 task_id를 반환하며, 이를 통해 진행 상황을 추적할 수 있습니다.
실시간 프로덕션 사용을 위해 선택적 webhook_url 매개변수를 포함하면 작업이 완료된 후 자동 알림을 받을 수 있습니다.




## OpenAPI

````yaml /openapi/registry.ko.yaml post /proxy/freepik/v1/ai/image-upscaler
openapi: 3.0.2
info:
  title: Comfy API
  version: '1.0'
servers:
  - url: https://api.comfy.org
security: []
paths:
  /proxy/freepik/v1/ai/image-upscaler:
    post:
      tags:
        - Freepik
        - Proxy
      summary: Magnific으로 이미지 업스케일링
      description: |
        이 비동기 엔드포인트는 고급 AI 알고리즘을 사용하여 이미지 업스케일링을 가능하게 합니다.
        제출 시 고유한 task_id를 반환하며, 이를 통해 진행 상황을 추적할 수 있습니다.
        실시간 프로덕션 사용을 위해 선택적 webhook_url 매개변수를 포함하면 작업이 완료된 후 자동 알림을 받을 수 있습니다.
      operationId: FreepikMagnificUpscalerCreative
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FreepikMagnificUpscalerCreativeRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FreepikTaskResponse'
          description: OK - 업스케일링 프로세스가 시작되었습니다.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FreepikErrorResponse'
          description: 잘못된 요청
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FreepikErrorResponse'
          description: 내부 서버 오류
      security:
        - BearerAuth: []
components:
  schemas:
    FreepikMagnificUpscalerCreativeRequest:
      properties:
        creativity:
          default: 0
          description: AI의 창의성을 높이거나 낮춥니다. 유효 값 범위는 [-10, 10]입니다.
          maximum: 10
          minimum: -10
          type: integer
        engine:
          default: automatic
          description: Magnific 모델 엔진입니다.
          enum:
            - automatic
            - magnific_illusio
            - magnific_sharpy
            - magnific_sparkle
          type: string
        fractality:
          default: 0
          description: 프롬프트의 강도와 제곱 픽셀당 복잡성을 제어합니다. 유효 값 범위는 [-10, 10]입니다.
          maximum: 10
          minimum: -10
          type: integer
        hdr:
          default: 0
          description: 선명도와 세부 수준을 높이거나 낮춥니다. 유효 값 범위는 [-10, 10]입니다.
          maximum: 10
          minimum: -10
          type: integer
        image:
          description: 업스케일할 Base64 이미지 또는 URL. 결과 이미지는 최대 허용 크기인 2530만 픽셀을 초과할 수 없습니다.
          type: string
        optimized_for:
          default: standard
          description: 업스케일 프로세스를 최적화하기 위한 스타일입니다.
          enum:
            - standard
            - soft_portraits
            - hard_portraits
            - art_n_illustration
            - videogame_assets
            - nature_n_landscapes
            - films_n_photography
            - 3d_renders
            - science_fiction_n_horror
          type: string
        prompt:
          description: 업스케일 프로세스를 안내하는 프롬프트입니다. AI 생성 이미지에 동일한 프롬프트를 재사용하면 결과가 향상됩니다.
          type: string
        resemblance:
          default: 0
          description: 원본 이미지와의 유사도 수준을 조정합니다. 유효 값 범위는 [-10, 10]입니다.
          maximum: 10
          minimum: -10
          type: integer
        scale_factor:
          default: 2x
          description: 이미지의 크기 조절 비율을 구성합니다. 비율이 높을수록 이미지 처리 시간이 길어집니다.
          enum:
            - 2x
            - 4x
            - 8x
            - 16x
          type: string
        webhook_url:
          description: 작업 상태가 변경될 때마다 비동기 알림을 수신하는 선택적 콜백 URL입니다.
          example: https://www.example.com/webhook
          format: uri
          type: string
      required:
        - image
      type: object
    FreepikTaskResponse:
      properties:
        data:
          $ref: '#/components/schemas/FreepikTaskData'
      required:
        - data
      type: object
    FreepikErrorResponse:
      properties:
        error:
          type: string
        message:
          type: string
      type: object
    FreepikTaskData:
      properties:
        generated:
          description: 생성된 이미지의 URL입니다.
          items:
            format: uri
            type: string
          type: array
        status:
          enum:
            - CREATED
            - IN_PROGRESS
            - COMPLETED
            - FAILED
          type: string
        task_id:
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          format: uuid
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````