{"openapi":"3.0.3","info":{"title":"APICK 에이픽 이미지 AI","version":"1.0.0","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/image-generation/generate":{"post":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"request_id":{"type":"string","description":"이미지 생성 요청 ID."},"image_count":{"type":"integer","description":"생성된 이미지 수."},"idempotent_replay":{"type":"boolean","description":"호환용 필드입니다. 같은 요청도 매번 새로 생성하므로 true가 되지 않습니다."},"images":{"type":"array","description":"생성한 이미지 목록.","items":{"type":"object","properties":{"index":{"type":"integer","description":"0부터 시작하는 이미지 번호."},"b64_json":{"type":"string","description":"이미지 바이트의 Base64 문자열."},"mime_type":{"type":"string","description":"이미지 MIME.","enum":["image/png","image/jpeg","image/webp"]},"width":{"type":"integer","description":"이미지 너비(픽셀)."},"height":{"type":"integer","description":"이미지 높이(픽셀)."}}}}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"생성·편집할 이미지에 대한 설명입니다. 최대 28,000자까지 보낼 수 있으며, 피사체·배경·구도·화풍을 구체적으로 적을수록 결과가 안정적입니다. (string)","example":"오프화이트 스튜디오 배경, 무광 세라믹 화병 하나, 창문으로 들어오는 부드러운 오전 햇빛, 자연스러운 그림자, 고급 제품 사진, 이미지 안에 글자 없음"},"image_count":{"type":"string","description":"생성할 이미지 수. 동기 생성·편집은 1~4, 작업형 생성·편집은 1~50입니다. (integer)","default":"1","example":"2"},"quality":{"type":"string","description":"이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic 가능한 값은 3가지입니다. basic = 가장 낮은 품질·가장 빠른 처리 등급입니다. 초안·대량 생성에 적합하고 단가가 가장 낮습니다. advanced = 중간 품질 등급입니다. 기본과 프리미엄의 중간 속도·품질·단가를 가집니다. premium = 가장 높은 품질 등급입니다. 해상도·디테일이 좋은 대신 처리 시간과 단가가 가장 높습니다. (string)","enum":["basic","advanced","premium"],"example":"advanced"},"size":{"type":"string","description":"출력 이미지의 크기입니다. 1024x1024 같은 WxH 형식으로 보내며, 생략하면 1024x1024입니다. 모델별 지원 크기가 다르므로 견적·모델 설명을 확인하세요. 가능한 값은 5가지입니다. 1024x1024 = 가로·세로가 같은 1:1 정사각 이미지입니다. 프로필·썸네일처럼 정방형이 필요할 때 사용합니다. 1536x1024 = 가로 1536·세로 1024의 3:2 가로 이미지입니다. 풍경·배너에 적합합니다. 1024x1536 = 가로 1024·세로 1536의 2:3 세로 이미지입니다. 인물 전신·모바일 화면에 적합합니다. 1152x864 = 가로 1152·세로 864의 4:3 가로 이미지입니다. 일반 사진 비율입니다. 864x1152 = 가로 864·세로 1152의 3:4 세로 이미지입니다. 인쇄 비율에 가깝습니다. (string)","enum":["1024x1024","1536x1024","1024x1536","1152x864","864x1152"],"example":"1024x1024"},"output_format":{"type":"string","description":"생성 결과의 파일 형식입니다. png·jpeg·webp 중 선택하며, 생략하면 서비스 기본값(png)을 사용합니다. 투명 배경이 필요하면 png를 선택하세요. 가능한 값은 3가지입니다. png = 무손실 PNG 형식입니다. 투명 배경이 필요할 때 사용합니다. jpeg = 압축률이 높은 JPG 형식입니다. 사진·배경이 있는 이미지에 적합합니다. webp = 용량이 작은 WEBP 형식입니다. 웹 표시에 적합하며 일부 구형 뷰어는 지원하지 않습니다. (string)","enum":["png","jpeg","webp"],"example":"webp"},"background":{"type":"string","description":"이미지 배경을 투명·불투명 중 어떻게 처리할지 정합니다. transparent는 배경 제거, opaque는 원본 배경 유지이며, 지원 여부는 모델·출력 형식에 따라 다릅니다. 가능한 값은 3가지입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다. opaque = 배경을 불투명하게 채우는 값입니다. JPG처럼 알파 채널이 없는 형식과 호환됩니다. transparent = 배경을 투명하게 남기는 값입니다. PNG처럼 알파 채널을 지원하는 형식과 함께 써야 합니다. (string)","enum":["auto","opaque","transparent"],"example":"opaque"},"reference_image":{"type":"string","description":"생성 경로 전용. 제품·인물·색감·구도를 참고할 이미지 1장. 원본을 고치지 않고 프롬프트에 맞는 새 장면을 만듭니다. (file)","format":"binary"}},"required":["prompt"]}}}}}},"/rest/image-generation/edit":{"post":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"request_id":{"type":"string","description":"이미지 생성 요청 ID."},"image_count":{"type":"integer","description":"생성된 이미지 수."},"idempotent_replay":{"type":"boolean","description":"호환용 필드입니다. 같은 요청도 매번 새로 생성하므로 true가 되지 않습니다."},"images":{"type":"array","description":"생성한 이미지 목록.","items":{"type":"object","properties":{"index":{"type":"integer","description":"0부터 시작하는 이미지 번호."},"b64_json":{"type":"string","description":"이미지 바이트의 Base64 문자열."},"mime_type":{"type":"string","description":"이미지 MIME.","enum":["image/png","image/jpeg","image/webp"]},"width":{"type":"integer","description":"이미지 너비(픽셀)."},"height":{"type":"integer","description":"이미지 높이(픽셀)."}}}}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"생성·편집할 이미지에 대한 설명입니다. 최대 28,000자까지 보낼 수 있으며, 피사체·배경·구도·화풍을 구체적으로 적을수록 결과가 안정적입니다. (string)","example":"잔잔한 바닷가를 표현해 주세요."},"image_count":{"type":"string","description":"생성할 이미지 수. 동기 생성·편집은 1~4, 작업형 생성·편집은 1~50입니다. (integer)","default":"1"},"quality":{"type":"string","description":"이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic 가능한 값은 3가지입니다. basic = 가장 낮은 품질·가장 빠른 처리 등급입니다. 초안·대량 생성에 적합하고 단가가 가장 낮습니다. advanced = 중간 품질 등급입니다. 기본과 프리미엄의 중간 속도·품질·단가를 가집니다. premium = 가장 높은 품질 등급입니다. 해상도·디테일이 좋은 대신 처리 시간과 단가가 가장 높습니다. (string)","enum":["basic","advanced","premium"]},"size":{"type":"string","description":"출력 이미지의 크기입니다. 1024x1024 같은 WxH 형식으로 보내며, 생략하면 1024x1024입니다. 모델별 지원 크기가 다르므로 견적·모델 설명을 확인하세요. 가능한 값은 5가지입니다. 1024x1024 = 가로·세로가 같은 1:1 정사각 이미지입니다. 프로필·썸네일처럼 정방형이 필요할 때 사용합니다. 1536x1024 = 가로 1536·세로 1024의 3:2 가로 이미지입니다. 풍경·배너에 적합합니다. 1024x1536 = 가로 1024·세로 1536의 2:3 세로 이미지입니다. 인물 전신·모바일 화면에 적합합니다. 1152x864 = 가로 1152·세로 864의 4:3 가로 이미지입니다. 일반 사진 비율입니다. 864x1152 = 가로 864·세로 1152의 3:4 세로 이미지입니다. 인쇄 비율에 가깝습니다. (string)","enum":["1024x1024","1536x1024","1024x1536","1152x864","864x1152"]},"output_format":{"type":"string","description":"생성 결과의 파일 형식입니다. png·jpeg·webp 중 선택하며, 생략하면 서비스 기본값(png)을 사용합니다. 투명 배경이 필요하면 png를 선택하세요. 가능한 값은 3가지입니다. png = 무손실 PNG 형식입니다. 투명 배경이 필요할 때 사용합니다. jpeg = 압축률이 높은 JPG 형식입니다. 사진·배경이 있는 이미지에 적합합니다. webp = 용량이 작은 WEBP 형식입니다. 웹 표시에 적합하며 일부 구형 뷰어는 지원하지 않습니다. (string)","enum":["png","jpeg","webp"]},"background":{"type":"string","description":"이미지 배경을 투명·불투명 중 어떻게 처리할지 정합니다. transparent는 배경 제거, opaque는 원본 배경 유지이며, 지원 여부는 모델·출력 형식에 따라 다릅니다. 가능한 값은 3가지입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다. opaque = 배경을 불투명하게 채우는 값입니다. JPG처럼 알파 채널이 없는 형식과 호환됩니다. transparent = 배경을 투명하게 남기는 값입니다. PNG처럼 알파 채널을 지원하는 형식과 함께 써야 합니다. (string)","enum":["auto","opaque","transparent"]},"image":{"type":"string","description":"편집 경로 전용이며 필수. 바꿀 원본 이미지 1장. 유지할 부분과 바꿀 부분을 프롬프트에 함께 적으세요. (file)","format":"binary"}},"required":["prompt","image"]}}}}}},"/rest/image-generation/jobs/generate":{"post":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 또는 재전송 시점의 작업 상태."},"requested_count":{"type":"integer","description":"요청 이미지 수."},"cost_per_image":{"type":"number","description":"이미지 1장당 접수 시 단가(포인트)."},"prepaid_point":{"type":"number","description":"선결제 포인트."},"idempotent_replay":{"type":"boolean","description":"호환용 필드로 항상 false입니다. 같은 요청도 매번 새 작업으로 접수합니다."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 또는 재전송 시점의 작업 상태."},"requested_count":{"type":"integer","description":"요청 이미지 수."},"cost_per_image":{"type":"number","description":"이미지 1장당 접수 시 단가(포인트)."},"prepaid_point":{"type":"number","description":"선결제 포인트."},"idempotent_replay":{"type":"boolean","description":"호환용 필드로 항상 false입니다. 같은 요청도 매번 새 작업으로 접수합니다."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"생성·편집할 이미지에 대한 설명입니다. 최대 28,000자까지 보낼 수 있으며, 피사체·배경·구도·화풍을 구체적으로 적을수록 결과가 안정적입니다. (string)","example":"잔잔한 바닷가를 표현해 주세요."},"image_count":{"type":"string","description":"생성할 이미지 수. 동기 생성·편집은 1~4, 작업형 생성·편집은 1~50입니다. (integer)","default":"1"},"quality":{"type":"string","description":"이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic 가능한 값은 3가지입니다. basic = 가장 낮은 품질·가장 빠른 처리 등급입니다. 초안·대량 생성에 적합하고 단가가 가장 낮습니다. advanced = 중간 품질 등급입니다. 기본과 프리미엄의 중간 속도·품질·단가를 가집니다. premium = 가장 높은 품질 등급입니다. 해상도·디테일이 좋은 대신 처리 시간과 단가가 가장 높습니다. (string)","enum":["basic","advanced","premium"]},"size":{"type":"string","description":"출력 이미지의 크기입니다. 1024x1024 같은 WxH 형식으로 보내며, 생략하면 1024x1024입니다. 모델별 지원 크기가 다르므로 견적·모델 설명을 확인하세요. 가능한 값은 5가지입니다. 1024x1024 = 가로·세로가 같은 1:1 정사각 이미지입니다. 프로필·썸네일처럼 정방형이 필요할 때 사용합니다. 1536x1024 = 가로 1536·세로 1024의 3:2 가로 이미지입니다. 풍경·배너에 적합합니다. 1024x1536 = 가로 1024·세로 1536의 2:3 세로 이미지입니다. 인물 전신·모바일 화면에 적합합니다. 1152x864 = 가로 1152·세로 864의 4:3 가로 이미지입니다. 일반 사진 비율입니다. 864x1152 = 가로 864·세로 1152의 3:4 세로 이미지입니다. 인쇄 비율에 가깝습니다. (string)","enum":["1024x1024","1536x1024","1024x1536","1152x864","864x1152"]},"output_format":{"type":"string","description":"생성 결과의 파일 형식입니다. png·jpeg·webp 중 선택하며, 생략하면 서비스 기본값(png)을 사용합니다. 투명 배경이 필요하면 png를 선택하세요. 가능한 값은 3가지입니다. png = 무손실 PNG 형식입니다. 투명 배경이 필요할 때 사용합니다. jpeg = 압축률이 높은 JPG 형식입니다. 사진·배경이 있는 이미지에 적합합니다. webp = 용량이 작은 WEBP 형식입니다. 웹 표시에 적합하며 일부 구형 뷰어는 지원하지 않습니다. (string)","enum":["png","jpeg","webp"]},"background":{"type":"string","description":"이미지 배경을 투명·불투명 중 어떻게 처리할지 정합니다. transparent는 배경 제거, opaque는 원본 배경 유지이며, 지원 여부는 모델·출력 형식에 따라 다릅니다. 가능한 값은 3가지입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다. opaque = 배경을 불투명하게 채우는 값입니다. JPG처럼 알파 채널이 없는 형식과 호환됩니다. transparent = 배경을 투명하게 남기는 값입니다. PNG처럼 알파 채널을 지원하는 형식과 함께 써야 합니다. (string)","enum":["auto","opaque","transparent"]},"reference_image":{"type":"string","description":"생성 경로 전용. 제품·인물·색감·구도를 참고할 이미지 1장. 원본을 고치지 않고 프롬프트에 맞는 새 장면을 만듭니다. (file)","format":"binary"}},"required":["prompt"]}}}}}},"/rest/image-generation/jobs/edit":{"post":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 또는 재전송 시점의 작업 상태."},"requested_count":{"type":"integer","description":"요청 이미지 수."},"cost_per_image":{"type":"number","description":"이미지 1장당 접수 시 단가(포인트)."},"prepaid_point":{"type":"number","description":"선결제 포인트."},"idempotent_replay":{"type":"boolean","description":"호환용 필드로 항상 false입니다. 같은 요청도 매번 새 작업으로 접수합니다."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 또는 재전송 시점의 작업 상태."},"requested_count":{"type":"integer","description":"요청 이미지 수."},"cost_per_image":{"type":"number","description":"이미지 1장당 접수 시 단가(포인트)."},"prepaid_point":{"type":"number","description":"선결제 포인트."},"idempotent_replay":{"type":"boolean","description":"호환용 필드로 항상 false입니다. 같은 요청도 매번 새 작업으로 접수합니다."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"생성·편집할 이미지에 대한 설명입니다. 최대 28,000자까지 보낼 수 있으며, 피사체·배경·구도·화풍을 구체적으로 적을수록 결과가 안정적입니다. (string)","example":"잔잔한 바닷가를 표현해 주세요."},"image_count":{"type":"string","description":"생성할 이미지 수. 동기 생성·편집은 1~4, 작업형 생성·편집은 1~50입니다. (integer)","default":"1"},"quality":{"type":"string","description":"이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic 가능한 값은 3가지입니다. basic = 가장 낮은 품질·가장 빠른 처리 등급입니다. 초안·대량 생성에 적합하고 단가가 가장 낮습니다. advanced = 중간 품질 등급입니다. 기본과 프리미엄의 중간 속도·품질·단가를 가집니다. premium = 가장 높은 품질 등급입니다. 해상도·디테일이 좋은 대신 처리 시간과 단가가 가장 높습니다. (string)","enum":["basic","advanced","premium"]},"size":{"type":"string","description":"출력 이미지의 크기입니다. 1024x1024 같은 WxH 형식으로 보내며, 생략하면 1024x1024입니다. 모델별 지원 크기가 다르므로 견적·모델 설명을 확인하세요. 가능한 값은 5가지입니다. 1024x1024 = 가로·세로가 같은 1:1 정사각 이미지입니다. 프로필·썸네일처럼 정방형이 필요할 때 사용합니다. 1536x1024 = 가로 1536·세로 1024의 3:2 가로 이미지입니다. 풍경·배너에 적합합니다. 1024x1536 = 가로 1024·세로 1536의 2:3 세로 이미지입니다. 인물 전신·모바일 화면에 적합합니다. 1152x864 = 가로 1152·세로 864의 4:3 가로 이미지입니다. 일반 사진 비율입니다. 864x1152 = 가로 864·세로 1152의 3:4 세로 이미지입니다. 인쇄 비율에 가깝습니다. (string)","enum":["1024x1024","1536x1024","1024x1536","1152x864","864x1152"]},"output_format":{"type":"string","description":"생성 결과의 파일 형식입니다. png·jpeg·webp 중 선택하며, 생략하면 서비스 기본값(png)을 사용합니다. 투명 배경이 필요하면 png를 선택하세요. 가능한 값은 3가지입니다. png = 무손실 PNG 형식입니다. 투명 배경이 필요할 때 사용합니다. jpeg = 압축률이 높은 JPG 형식입니다. 사진·배경이 있는 이미지에 적합합니다. webp = 용량이 작은 WEBP 형식입니다. 웹 표시에 적합하며 일부 구형 뷰어는 지원하지 않습니다. (string)","enum":["png","jpeg","webp"]},"background":{"type":"string","description":"이미지 배경을 투명·불투명 중 어떻게 처리할지 정합니다. transparent는 배경 제거, opaque는 원본 배경 유지이며, 지원 여부는 모델·출력 형식에 따라 다릅니다. 가능한 값은 3가지입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다. opaque = 배경을 불투명하게 채우는 값입니다. JPG처럼 알파 채널이 없는 형식과 호환됩니다. transparent = 배경을 투명하게 남기는 값입니다. PNG처럼 알파 채널을 지원하는 형식과 함께 써야 합니다. (string)","enum":["auto","opaque","transparent"]},"image":{"type":"string","description":"편집 경로 전용이며 필수. 바꿀 원본 이미지 1장. 유지할 부분과 바꿀 부분을 프롬프트에 함께 적으세요. (file)","format":"binary"}},"required":["prompt","image"]}}}}}},"/rest/image-generation/jobs/{job_id}":{"get":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"작업 상태.","enum":["waiting","processing","completed","completed_partial","failed"]},"requested_count":{"type":"integer","description":"요청 이미지 수."},"completed_count":{"type":"integer","description":"완료 이미지 수."},"failed_count":{"type":"integer","description":"실패 이미지 수."},"prepaid_point":{"type":"number","description":"선결제 포인트."},"refunded_point":{"type":"number","description":"환급 포인트."},"charged_point":{"type":"number","description":"최종 차감 포인트."},"result_available":{"type":"boolean","description":"다운로드 가능한 결과가 있는지 여부."},"expires_at":{"type":"string","description":"결과 만료 일시.","nullable":true},"error_code":{"type":"string","description":"작업 실패 코드. 오류가 없으면 null.","nullable":true}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/image-generation/jobs/{job_id}/images/{index}":{"get":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"index","in":"path","required":true,"schema":{"type":"integer","minimum":0,"maximum":49}}],"responses":{"200":{"description":"파일 직접 응답","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/image-generation/jobs/{job_id}/result":{"get":{"summary":"에이픽 이미지 AI","description":"텍스트만으로, 또는 참고 이미지와 설명을 함께 써서 새 이미지를 만듭니다. 원본 이미지 편집과 최대 50장의 대량 작업도 지원합니다. 요금은 품질별 장당 고정가(기본 40P · 고급 350P · 최고급 1,400P)이며 크기와 관계없이 같습니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"파일 직접 응답","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"APICK_IMAGE_INVALID_REQUEST (400): 프롬프트에 사용할 수 없는 문자를 제거하세요.\nAPICK_IMAGE_PROMPT_REQUIRED (400): 비어 있지 않은 prompt를 입력하세요.\nAPICK_IMAGE_PROMPT_TOO_LONG (400): 프롬프트를 28,000자 이하로 줄이세요.\nAPICK_IMAGE_SIZE_INVALID (400): 지원하는 표준 크기를 선택하세요.\nAPICK_IMAGE_QUALITY_INVALID (400): quality는 basic, advanced, premium 중 하나로 보내세요.\nAPICK_IMAGE_OPTION_NOT_SUPPORTED (400): 지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요.\nAPICK_IMAGE_COUNT_INVALID (400): 동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요.\nAPICK_IMAGE_FORMAT_INVALID (400): png, jpeg, webp 중 하나를 선택하세요.\nAPICK_IMAGE_BACKGROUND_INVALID (400): auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요.\nAPICK_IMAGE_SOURCE_REQUIRED (400): 올바른 필드에 단일 이미지 파일을 첨부하세요.\nAPICK_IMAGE_SOURCE_INVALID (400·413): 비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요.\nAPICK_IMAGE_AUTH_FAILED (401): 인증키와 계정을 확인하세요.\nAPICK_IMAGE_POINTS_INSUFFICIENT (402): 필요한 포인트를 충전하세요.\nAPICK_IMAGE_CONTENT_REJECTED (422): 프롬프트 또는 입력 이미지를 변경하세요.\nAPICK_IMAGE_RATE_LIMITED (429): 요청 간격을 늘린 뒤 다시 시도하세요.\nAPICK_IMAGE_TIMEOUT (408): 처리 시간이 초과됐습니다. 작업 상태를 확인하세요.\nAPICK_IMAGE_TEMPORARILY_UNAVAILABLE (503): 잠시 후 다시 시도하세요.\nAPICK_IMAGE_RESULT_INVALID (502): 실패 상태와 환급 내역을 확인하세요.\nAPICK_IMAGE_BILLING_FAILED (424): 결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요.\nAPICK_IMAGE_JOB_NOT_FOUND (404): 작업 소유권·작업 ID·이미지 번호를 확인하세요.\nAPICK_IMAGE_JOB_CONFLICT (409): 다운로드할 이미지의 생성 완료 여부를 확인하세요.\nAPICK_IMAGE_RESULT_EXPIRED (410): 보관 기간이 만료됐거나 결과 파일이 없습니다.\nAPICK_IMAGE_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-code-tables":[],"x-service-errors":[{"code":"APICK_IMAGE_INVALID_REQUEST","status":400,"message":"프롬프트에 사용할 수 없는 문자를 제거하세요."},{"code":"APICK_IMAGE_PROMPT_REQUIRED","status":400,"message":"비어 있지 않은 prompt를 입력하세요."},{"code":"APICK_IMAGE_PROMPT_TOO_LONG","status":400,"message":"프롬프트를 28,000자 이하로 줄이세요."},{"code":"APICK_IMAGE_SIZE_INVALID","status":400,"message":"지원하는 표준 크기를 선택하세요."},{"code":"APICK_IMAGE_QUALITY_INVALID","status":400,"message":"quality는 basic, advanced, premium 중 하나로 보내세요."},{"code":"APICK_IMAGE_OPTION_NOT_SUPPORTED","status":400,"message":"지원하지 않는 조정 옵션 또는 파일 필드를 제거하세요."},{"code":"APICK_IMAGE_COUNT_INVALID","status":400,"message":"동기는 1~4장, 작업형은 1~50장의 정수를 입력하세요."},{"code":"APICK_IMAGE_FORMAT_INVALID","status":400,"message":"png, jpeg, webp 중 하나를 선택하세요."},{"code":"APICK_IMAGE_BACKGROUND_INVALID","status":400,"message":"auto, opaque, transparent 중 선택하세요. 투명 배경에는 PNG·WebP를 사용하세요."},{"code":"APICK_IMAGE_SOURCE_REQUIRED","status":400,"message":"올바른 필드에 단일 이미지 파일을 첨부하세요."},{"code":"APICK_IMAGE_SOURCE_INVALID","status":"400·413","message":"비어 있지 않은 50MB 이하 PNG·JPEG·WebP를 첨부하세요."},{"code":"APICK_IMAGE_AUTH_FAILED","status":401,"message":"인증키와 계정을 확인하세요."},{"code":"APICK_IMAGE_POINTS_INSUFFICIENT","status":402,"message":"필요한 포인트를 충전하세요."},{"code":"APICK_IMAGE_CONTENT_REJECTED","status":422,"message":"프롬프트 또는 입력 이미지를 변경하세요."},{"code":"APICK_IMAGE_RATE_LIMITED","status":429,"message":"요청 간격을 늘린 뒤 다시 시도하세요."},{"code":"APICK_IMAGE_TIMEOUT","status":408,"message":"처리 시간이 초과됐습니다. 작업 상태를 확인하세요."},{"code":"APICK_IMAGE_TEMPORARILY_UNAVAILABLE","status":503,"message":"잠시 후 다시 시도하세요."},{"code":"APICK_IMAGE_RESULT_INVALID","status":502,"message":"실패 상태와 환급 내역을 확인하세요."},{"code":"APICK_IMAGE_BILLING_FAILED","status":424,"message":"결제 처리를 완료하지 못했습니다. 작업과 포인트 상태를 확인하세요."},{"code":"APICK_IMAGE_JOB_NOT_FOUND","status":404,"message":"작업 소유권·작업 ID·이미지 번호를 확인하세요."},{"code":"APICK_IMAGE_JOB_CONFLICT","status":409,"message":"다운로드할 이미지의 생성 완료 여부를 확인하세요."},{"code":"APICK_IMAGE_RESULT_EXPIRED","status":410,"message":"보관 기간이 만료됐거나 결과 파일이 없습니다."},{"code":"APICK_IMAGE_INTERNAL_ERROR","status":500,"message":"잠시 후 다시 시도하세요."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}