품질 높이기
목적
이 엔드포인트는 업로드된 이미지의 품질을 더 높은 해상도로 높입니다. 원본 이미지를 1K, 2K 또는 4K 해상도로 확장하여 더 선명하고 고품질의 이미지를 생성합니다. 웹 앱의 "품질 높이기" 페이지와 동일한 기능이며, 웹 앱에서는 기본적으로 2K가 선택됩니다.
크레딧 비용: 5 (1K), 7 (2K), 10 (4K)
메서드 및 경로
- HTTP 메서드:
POST - 경로:
/public/v1/image-tune/upscale
인증
이 엔드포인트는 Bearer Token 인증이 필요합니다. 자세한 내용은 인증 가이드를 참조하세요.
필수 헤더:
Authorization: Bearer {your_api_key}
요청 필드
폼 데이터 (multipart/form-data)
| 필드명 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
image | file | 필수 | 품질을 높일 원본 이미지 파일 (PNG 또는 JPEG) |
scale | string | 필수 | 목표 해상도. 가능한 값: "1K", "2K", "4K" |
Scale 값
"1K": 1024px 해상도로 높이기"2K": 2048px 해상도로 높이기"4K": 4096px 해상도로 높이기
응답
JobIdResponse
| 필드명 | 타입 | 설명 |
|---|---|---|
job_id | UUID | 생성된 작업의 고유 식별자. 이 ID로 작업 상태를 조회합니다 |
오류 / 유효성 검사 규칙
| HTTP 상태 코드 | 오류 상황 | 설명 |
|---|---|---|
400 Bad Request | Invalid image file | Invalid image file |
401 Unauthorized | 인증 실패 | 유효하지 않은 API 키 또는 누락된 인증 헤더 |
404 Not Found | 사용자 없음 | API 키에 연결된 사용자를 찾을 수 없음 |
422 Unprocessable Entity | 유효성 검사 실패 | 필수 필드 누락 또는 잘못된 scale 값 |
비동기 작업 동작
이 엔드포인트는 비동기로 처리됩니다. 요청 즉시 job_id를 반환하고, 실제 품질 높이기 처리는 백그라운드에서 진행됩니다.
작업 흐름:
- 이미지 파일과 scale 파라미터를 전송하면 즉시
job_id가 반환됩니다 - 백그라운드에서 품질 높이기 처리가 진행됩니다
GET /job/{job_id}엔드포인트로 폴링하여 상태를 확인합니다status가Succeed로 변경되면image_urls에서 결과 이미지 URL을 확인합니다
폴링 간격: 1-2초 권장
요청 예시
cURL
curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "scale=2K"
응답 예시
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}