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

# 개별 결과 파일 다운로드 URL 발급

> 완료된 삽입 주문의 결과 파일 1개에 대한 다운로드 URL을 발급합니다. [`GET /api/v3/orders/{orderId}`](/ko/api-reference/orders/get-order-v3)의 `outputs[].fileId`를 사용합니다.

URL은 300초 동안 유효합니다. 보관 기한이 지나면 `400 ORDER_EXPIRED`를 반환합니다.




## OpenAPI

````yaml ko/api-reference/openapi.yaml GET /api/v3/orders/{orderId}/files/{fileId}/download
openapi: 3.0.0
info:
  title: BIZ MORI API
  version: 2.0.0
  description: >
    BIZ MORI API는 디지털 콘텐츠 보호를 위한 네 가지 핵심 서비스를 제공합니다:

    - **Anti-AI**: 이미지를 AI 학습으로부터 보호

    - **Watermark Embed**: 이미지에 보이지 않는 디지털 워터마크 삽입

    - **Watermark Extract**: 이미지에서 워터마크 추출 및 검증

    - **AI Detection**: 이미지가 AI로 생성되었는지 감지

    - **테스트 API 키**: `sk_test_` 접두사의 키는 동일한 Bearer 인증을 사용하며, 실제 처리 서비스나 크레딧 사용
    없이 주문 흐름을 검증할 수 있습니다. 테스트 업로드는 파일 내용을 폐기하고 결과 파일을 만들지 않습니다
  contact:
    name: BIZ MORI 지원
    email: support@bizmori.com
  license:
    name: Proprietary
    url: https://docs.bizmori.com/legal/terms
servers:
  - url: https://api.bizmori.com
    description: 프로덕션
security: []
tags:
  - name: Anti-AI
    description: AI 학습 방지 이미지 보호 주문
  - name: Watermark Embed
    description: 워터마크 삽입 주문
  - name: Watermark Extract
    description: 워터마크 추출 주문
  - name: AI Detection
    description: AI 생성 이미지 감지 주문
  - name: Orders
    description: 주문 조회 및 관리
  - name: Webhooks
    description: 웹훅 설정 및 이벤트
  - name: Reports
    description: 워터마크 추출·AI Detection 주문의 PDF 분석 보고서
paths:
  /api/v3/orders/{orderId}/files/{fileId}/download:
    get:
      tags:
        - Orders
      summary: 개별 결과 파일 다운로드 URL 발급
      description: >
        완료된 삽입 주문의 결과 파일 1개에 대한 다운로드 URL을 발급합니다. [`GET
        /api/v3/orders/{orderId}`](/ko/api-reference/orders/get-order-v3)의
        `outputs[].fileId`를 사용합니다.


        URL은 300초 동안 유효합니다. 보관 기한이 지나면 `400 ORDER_EXPIRED`를 반환합니다.
      operationId: downloadWatermarkV1OutputFile
      parameters:
        - in: path
          name: orderId
          required: true
          schema:
            type: string
            pattern: ^[0-9]{1,20}$
          description: 주문 ID
        - in: path
          name: fileId
          required: true
          schema:
            type: string
            pattern: ^[0-9]+-[0-9]+$
          description: '`{inputFileId}-{순번}` 형식의 결과 파일 ID(`outputs[].fileId`)'
      responses:
        '200':
          description: 결과 파일의 서명 URL(300초 유효)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadLinkResponse'
        '400':
          description: 잘못된 요청, 완료되지 않은 주문, 또는 보관 기한이 지난 주문(`ORDER_EXPIRED`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                validation:
                  value:
                    code: VALIDATION_FAILED
                expired:
                  value:
                    code: ORDER_EXPIRED
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: 주문이 없거나 다른 계정의 주문
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                code: ORDER_NOT_FOUND
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: >
            curl -X GET
            https://api.bizmori.com/api/v3/orders/ORDER_ID/files/FILE_ID/download
            \
              -H "Authorization: Bearer YOUR_API_KEY"
        - lang: javascript
          label: JavaScript
          source: >
            const orderId = 'ORDER_ID';

            const fileId = 'FILE_ID';

            const response = await
            fetch(`https://api.bizmori.com/api/v3/orders/${orderId}/files/${fileId}/download`,
            {
              headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
            });

            const { data } = await response.json();
        - lang: python
          label: Python
          source: |
            import requests

            order_id = 'ORDER_ID'
            file_id = 'FILE_ID'
            response = requests.get(
                f'https://api.bizmori.com/api/v3/orders/{order_id}/files/{file_id}/download',
                headers={'Authorization': 'Bearer YOUR_API_KEY'}
            )
            data = response.json()['data']
components:
  schemas:
    DownloadLinkResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: object
          required:
            - downloadUrl
            - expiresInSeconds
          properties:
            downloadUrl:
              type: string
              format: uri
              description: 300초 동안 유효한 서명 다운로드 URL
            expiresInSeconds:
              type: integer
              example: 300
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: 에러 코드
  responses:
    Unauthorized:
      description: 인증 실패
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: AUTH_NOT_AUTHENTICATED
    InternalError:
      description: 내부 서버 오류
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: SERVER_INTERNAL_ERROR
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 `sk_` 접두사를 사용하고, 테스트 키는 `sk_test_`
        접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.