품질 향상기 (업스케일)

품질 향상기 엔드포인트를 사용하면 이미지의 해상도와 미세한 디테일을 지능적으로 업스케일하고 향상시켜 최대 4K 해상도를 지원할 수 있습니다.

요청

이미지와 목표 해상도를 범용 /v1/run 엔드포인트로 제출하세요:

요청 예시

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

응답

업스케일링은 최대 20초가 소요될 수 있으므로, /v1/run 엔드포인트는 비동기 작업 id와 함께 즉시 201 Created 상태를 반환합니다. 최종 이미지를 검색하려면 이 id를 사용하여 상태 API를 폴링해야 합니다. 또는 웹훅을 구성하여 알림을 자동으로 받을 수 있습니다. 당사의 웹훅 디스패처는 엄격한 15초 타임아웃을 적용합니다. 서버는 15초 이내에 2xx 상태 코드로 웹훅을 승인해야 하며, 그렇지 않으면 실패로 간주되어 나중에 다시 시도됩니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

작업이 완료되면 (status: "success"), output 필드에 결과 URL 배열이 포함됩니다:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

요청 매개변수

필수 매개변수

런타임 오류

이 기능의 런타임 오류는 오류 처리에 문서화된 공유 세트를 사용합니다. 처리 중 오류가 발생하면 status가 "error"로 업데이트되고 error 필드에 특정 실패 이유가 포함됩니다.

크레딧 비용

개발자 API 요청의 경우, 비용은 targetQuality에 따라 달라집니다.

공식: 비용 = 품질 크레딧