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

# 이미지 재조명

> AI를 사용하여 이미지에 재조명을 적용합니다. 이 엔드포인트는 생성된 이미지를 사용자 정의하기 위한 다양한 파라미터를 허용합니다.




## OpenAPI

````yaml /openapi/registry.ko.yaml post /proxy/freepik/v1/ai/image-relight
openapi: 3.0.2
info:
  title: Comfy API
  version: '1.0'
servers:
  - url: https://api.comfy.org
security: []
paths:
  /proxy/freepik/v1/ai/image-relight:
    post:
      tags:
        - Freepik
        - Proxy
      summary: 이미지 재조명
      description: |
        AI를 사용하여 이미지에 재조명을 적용합니다. 이 엔드포인트는 생성된 이미지를 사용자 정의하기 위한 다양한 파라미터를 허용합니다.
      operationId: FreepikMagnificRelight
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FreepikMagnificRelightRequest'
        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:
    FreepikMagnificRelightRequest:
      properties:
        advanced_settings:
          properties:
            blacks:
              default: 50
              description: 이미지에서 검정색 수준을 조정합니다.
              maximum: 100
              minimum: 0
              type: integer
            brightness:
              default: 50
              description: 이미지의 밝기 수준을 조정합니다.
              maximum: 100
              minimum: 0
              type: integer
            contrast:
              default: 50
              description: 이미지의 대비 수준을 조정합니다.
              maximum: 100
              minimum: 0
              type: integer
            engine:
              default: automatic
              description: |
                재조명을 위한 엔진 프리셋:
                - balanced: 다재다능한 일반 목적 옵션
                - cool: 더 차가운 톤으로 더 밝게
                - real: 사진 품질 향상을 목표 (실험적)
                - illusio: 일러스트 및 드로잉에 최적화
                - fairy: 판타지 테마 이미지에 적합
                - colorful_anime: 애니메이션, 만화 및 선명한 색상에 이상적
                - hard_transform: 원본 이미지를 크게 변경
                - softy: 약간 부드러운 효과, 그래픽 디자인에 적합
              enum:
                - automatic
                - balanced
                - cool
                - real
                - illusio
                - fairy
                - colorful_anime
                - hard_transform
                - softy
              type: string
            fixed_generation:
              default: false
              description: 활성화하면 동일한 설정을 사용하면 항상 동일한 이미지가 생성됩니다.
              type: boolean
            saturation:
              default: 50
              description: 이미지의 채도 수준을 조정합니다.
              maximum: 100
              minimum: 0
              type: integer
            transfer_light_a:
              default: automatic
              description: 라이트 전송의 강도를 조정합니다.
              enum:
                - automatic
                - low
                - medium
                - normal
                - high
                - high_on_faces
              type: string
            transfer_light_b:
              default: automatic
              description: 라이트 전송 강도도 수정합니다. 다양한 효과를 위해 transfer_light_a와 결합할 수 있습니다.
              enum:
                - automatic
                - composition
                - straight
                - smooth_in
                - smooth_out
                - smooth_both
                - reverse_both
                - soft_in
                - soft_out
                - soft_mid
                - strong_mid
                - style_shift
                - strong_shift
              type: string
            whites:
              default: 50
              description: 이미지에서 흰색 수준을 조정합니다.
              maximum: 100
              minimum: 0
              type: integer
          type: object
        change_background:
          default: true
          description: 활성화하면 프롬프트 및/또는 참조 이미지를 기반으로 배경을 변경합니다. 제품 배치 및 초상화에 유용합니다.
          type: boolean
        image:
          description: 재조명할 이미지의 Base64 또는 URL
          type: string
        interpolate_from_original:
          default: false
          description: 활성화하면 라이트 전송 강도 슬라이더를 사용하여 최종 이미지가 원본에서 보간됩니다.
          type: boolean
        light_transfer_strength:
          default: 100
          description: 라이트 전송 강도 수준. 0%는 원본에 가장 가깝게 유지하고, 100%는 최대 전송입니다.
          maximum: 100
          minimum: 0
          type: integer
        preserve_details:
          default: true
          description: 원본 이미지의 질감과 작은 세부 사항을 유지합니다. 제품 사진, 텍스트 등에 적합합니다.
          type: boolean
        prompt:
          description: >
            설명 프롬프트를 사용하여 생성 과정을 안내하고 라이트 전송에 영향을 줄 수 있습니다.

            중요: 괄호 안에 1에서 1.4 사이의 숫자를 사용하여 프롬프트에서 라이트의 특정 측면을 강조할 수 있습니다. 예:
            "(dark scene:1.3)".
          type: string
        style:
          default: standard
          description: 재조명 작업을 위한 스타일 프리셋
          enum:
            - standard
            - darker_but_realistic
            - clean
            - smooth
            - brighter
            - contrasted_n_hdr
            - just_composition
          type: string
        transfer_light_from_lightmap:
          description: >-
            라이트 전송을 위한 라이트맵의 Base64 또는 URL.
            'transfer_light_from_reference_image'와 호환되지 않습니다.
          type: string
        transfer_light_from_reference_image:
          description: >-
            라이트 전송을 위한 참조 이미지의 Base64 또는 URL. 'transfer_light_from_lightmap'와
            호환되지 않습니다.
          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

````