이미지 다운로드

이 문서에서는 SDK를 사용하지 않고 생성된 결과 이미지를 다운로드하는 방법을 소개합니다.

작업 객체

작업 객체는 다음과 같은 구조가 될 것 같습니다.

{
  "id": "1749902216266450789",
  "userId": "1541182147551506853",
  "parameters": { ... },
  "outputs": {
    "duration": 1.26,
    "detailParameters": {
      // ...
    },
    "mediaId": "459602685899547043",
    "extra": { ... }
  },
  "status": "completed",
  "startedAt": "2024-05-22T06:16:57.124Z",
  "endAt": "2024-05-22T06:16:59.422Z",
  "createdAt": "2024-05-22T06:16:56.946Z",
  "updatedAt": "2024-05-22T06:16:56.946Z",
}

작업 상태가 완료되면 task.outputs에는 결과가 포함된 값이 표시됩니다. outputs에 mediaId 필드가 있는 것을 확인할 수 있습니다. 이 mediaId는 생성된 이미지의 ID입니다. 배치 생성 시나리오의 경우 여러 이미지의 ID는 output.batch[].mediaId가 됩니다.

{
  "id": "1749903535747486198",
  "userId": "1541182147551506853",
  "parameters": { ... },
  "outputs": {
    "duration": 4.83,
    "detailParameters": { ... },
    "mediaId": "459604021635814417",
    "batch": [
      {
        "seed": 3283868009760115,
        "mediaId": "459604023097100648",
        "extra": { ... }
      },
      ...
    ]
  },
  "status": "completed",
  "startedAt": "2024-05-22T06:22:12.240Z",
  "endAt": "2024-05-22T06:22:18.229Z",
  "createdAt": "2024-05-22T06:22:11.557Z",
  "updatedAt": "2024-05-22T06:22:11.557Z"
}

이미지 다운로드 링크 가져오기

mediaId를 얻은 후, 특정 이미지 다운로드 링크를 얻기 위해 API를 사용해야 합니다.

이미지를 다운로드하고 싶다면 다음 엔드포인트를 사용하여 다운로드 링크를 얻을 수 있습니다. 실제 이미지 URL로 리디렉션됩니다.

GET https://api.pixai.art/v1/media/:mediaId/image

이미지 URL, 썸네일 URL 등을 포함한 자세한 이미지 정보를 원하시면 Query.media 쿼리에 액세스하여 mediaId를 매개변수로 전달할 수 있습니다.

query getMediaById($id: String!) {
  media(id: $id) {
    urls {
      variant
      url
    }
  }
}

또는 매개변수로 mediaId를 사용하여 다음 RESTful API를 사용하세요.

GET https://api.pixai.art/v1/media/:mediaId

결과를 얻은 후에는 Media.urls 필드에 액세스하여 다운로드 링크를 얻어야 합니다.

Media.urls의 variant 필드는 이미지의 유형입니다. url 필드는 이미지의 다운로드 링크입니다.

이미지의 여러 변형을 동시에 제공합니다. 생성 후 원본 이미지에 액세스하려면 일반적으로 어떤 variant이 PUBLIC인지 URL을 선택해야 합니다.

{
  "data": {
    "media": {
      "urls": [
        {
          "variant": "PUBLIC",
          "url": "..."
        },
        {
          "variant": "THUMBNAIL",
          "url": "..."
        },
        {
          "variant": "STILL_THUMBNAIL",
          "url": "..."
        }
      ]
    }
  }
}

GraphQL 배치 쿼리를 사용하여 여러 이미지를 한 번에 가져올 수 있습니다. GraphQL 쿼리는 아래와 유사합니다.

query {
  media(id: "459604023097100648") {
    urls {
      variant
      url
    }
  }
  media(id: "459604023097100649") {
    urls {
      variant
      url
    }
  }
  media(id: "459604023097100650") {
    urls {
      variant
      url
    }
  }
}