{"openapi":"3.0.3","info":{"title":"APICK Kling 영상 생성 AI","version":"1.0.0","description":"3.0·o1·o3 버전과 텍스트·이미지·참조 소재 입력으로 최대 15초 영상을 만드는 생성 API"},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/kling/jobs":{"post":{"summary":"Kling 영상 생성 AI","description":"3.0·o1·o3 버전과 텍스트·이미지·참조 소재 입력으로 최대 15초 영상을 만드는 생성 API","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"description":"영상 작업 공개 상태. 처리 단계에서 제공되는 항목만 포함합니다.","type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"model":{"type":"string","description":"요청한 영상 제품.","enum":["seedance","veo","kling"]},"version":{"type":"string","description":"선택한 제품 버전."},"mode":{"type":"string","description":"입력 방식.","enum":["text","image","reference"]},"tier":{"type":"string","description":"선택한 생성 등급."},"status":{"type":"string","description":"현재 작업 상태.","enum":["waiting","processing","completed","failed"]},"duration":{"type":"integer","description":"요청 영상 길이(초)."},"aspect_ratio":{"type":"string","description":"영상 화면 비율."},"resolution":{"type":"string","description":"영상 해상도."},"audio":{"type":"boolean","description":"오디오 생성 여부."},"point_per_second":{"type":"number","description":"접수 시 적용한 초당 포인트."},"charged_point":{"type":"number","description":"접수 시 차감한 전체 포인트."},"result_available":{"type":"boolean","description":"결과가 완료되어 다운로드 가능한지 여부."},"result_expires_at":{"type":"string","description":"결과 만료 ISO 8601 일시. 결과가 없으면 null.","nullable":true},"result_url":{"type":"string","description":"완료·미만료 상태에서만 제공되는 에이픽 결과 다운로드 주소."},"created_at":{"type":"string","description":"작업 생성 일시."},"completed_at":{"type":"string","description":"작업 완료 일시. 완료 전에는 null일 수 있습니다.","nullable":true},"error":{"type":"object","description":"실패한 작업에만 포함합니다.","properties":{"code":{"type":"string","description":"작업 실패의 공개 오류코드."},"message":{"type":"string","description":"실패 내용. 설명이 없으면 null.","nullable":true}}},"idempotent_replay":{"type":"boolean","description":"같은 멱등 키로 기존 작업을 반환하면 true. 재전송의 api.cost는 0입니다."},"price_source":{"type":"string","description":"신규 접수 단가 기준. live=실시간 견적, table=기본 단가표.","enum":["live","table"]}}},"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_VIDEO_AUTH_FAILED (401): 인증에 실패했습니다.\nAPICK_VIDEO_ACCESS_DISABLED (403): API 이용이 제한된 계정입니다.\nAPICK_VIDEO_PAYMENT_REQUIRED (403): 최소 1회 결제 후 이용할 수 있습니다.\nAPICK_VIDEO_POINTS_INSUFFICIENT (402): 사용 가능한 포인트가 부족합니다.\nAPICK_VIDEO_INVALID_REQUEST (400): 요청 내용을 확인해 주세요.\nAPICK_VIDEO_PROMPT_REQUIRED (400): prompt를 입력해 주세요.\nAPICK_VIDEO_PROMPT_TOO_LONG (400): prompt는 최대 2,000자입니다.\nAPICK_VIDEO_MODE_INVALID (400): mode는 text, image, reference 중 하나여야 합니다.\nAPICK_VIDEO_MODE_NOT_SUPPORTED (400): 이 모델에서는 지원하지 않는 mode입니다.\nAPICK_VIDEO_DURATION_INVALID (400): duration 값이 허용 범위를 벗어났습니다.\nAPICK_VIDEO_ASPECT_RATIO_INVALID (400): aspect_ratio 값이 허용 목록에 없습니다.\nAPICK_VIDEO_RESOLUTION_INVALID (400): resolution 값이 허용 목록에 없습니다.\nAPICK_VIDEO_TIER_INVALID (400): tier 값이 허용 목록에 없습니다.\nAPICK_VIDEO_VERSION_INVALID (400): 지원하지 않는 영상 모델 버전입니다.\nAPICK_VIDEO_OPTION_NOT_SUPPORTED (400): 이 모델·mode에서는 지원하지 않는 옵션입니다.\nAPICK_VIDEO_SOURCE_REQUIRED (400): 이 mode에는 입력 파일이 필요합니다.\nAPICK_VIDEO_SOURCE_TOO_MANY (400): 입력 파일 개수가 허용 범위를 초과했습니다.\nAPICK_VIDEO_SOURCE_INVALID (400): 입력 파일 형식이나 크기를 확인해 주세요.\nAPICK_VIDEO_IDEMPOTENCY_CONFLICT (409): 같은 idempotency_key에 다른 요청을 사용할 수 없습니다.\nAPICK_VIDEO_TOO_MANY_ACTIVE_JOBS (429): 동시에 진행할 수 있는 작업 수를 초과했습니다.\nAPICK_VIDEO_CONTENT_REJECTED (422): 요청한 영상을 생성할 수 없습니다. 프롬프트나 입력 파일을 확인해 주세요.\nAPICK_VIDEO_RATE_LIMITED (429): 현재 요청이 많습니다. 잠시 후 다시 시도해 주세요.\nAPICK_VIDEO_TEMPORARILY_UNAVAILABLE (503): 현재 영상 서비스를 이용할 수 없습니다. 잠시 후 다시 시도해 주세요.\nAPICK_VIDEO_TIMEOUT (408): 처리 시간이 초과됐습니다. 포인트는 환불되었습니다.\nAPICK_VIDEO_GENERATION_FAILED (500): 영상 생성에 실패했습니다. 포인트는 환불되었습니다.\nAPICK_VIDEO_JOB_NOT_FOUND (404): 작업을 찾을 수 없습니다.\nAPICK_VIDEO_JOB_CONFLICT (409): 현재 작업 상태에서는 요청을 처리할 수 없습니다.\nAPICK_VIDEO_RESULT_EXPIRED (410): 결과 보관 기간이 만료되었습니다.\nAPICK_VIDEO_RESULT_INVALID (502): 생성 결과를 확인할 수 없습니다.\nAPICK_VIDEO_BILLING_FAILED (424): 결제 원장을 완료하지 못했습니다.\nAPICK_VIDEO_INTERNAL_ERROR (500): 영상 서비스 내부 오류가 발생했습니다.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"생성할 영상의 장면·동작·카메라 움직임을 설명합니다. 최대 2,000자이며, 구체적인 피사체와 배경을 적을수록 의도에 가까운 결과가 나옵니다. (string)","example":"도심 야경 속을 걷는 인물의 뒷모습, 네온 반사"},"version":{"type":"string","description":"영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. 가능한 값은 3가지입니다. 3.0 = 3.0 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. o3 = o3 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. o1 = o1 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. (string)","enum":["3.0","o3","o1"]},"mode":{"type":"string","description":"입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text 가능한 값은 3가지입니다. text = 텍스트 프롬프트만으로 결과를 만드는 값입니다. 이미지 입력 없이 문장 묘사만 사용합니다. image = 이미지 1장을 첫 프레임·기준 이미지로 쓰는 값입니다. 이미지와 프롬프트를 함께 보냅니다. reference = 참조 이미지·영상을 스타일 기준으로 쓰는 값입니다. 여러 장을 보낼 수 있고, 제품별 최대 장수가 다릅니다. (string)","enum":["text","image","reference"]},"tier":{"type":"string","description":"품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. 가능한 값은 5가지입니다. std = 표준 품질 등급입니다. 표기만 std이며 standard와 같은 뜻으로 쓰는 제품이 많습니다. pro = 상위 품질 등급입니다. 표준보다 화질·디테일이 좋고 처리 시간과 요금이 더 큽니다. turbo = 가장 빠른 생성 등급입니다. 짧은 대기 시간을 우선할 때 쓰며 화질은 표준보다 낮을 수 있습니다. 4k = 4K 해상도 출력을 전제로 한 고화질 등급입니다. 지원 버전이 제한되고 단가가 가장 높습니다. standard = 표준 품질·속도 등급입니다. 대부분 제품의 기본값이며 품질과 처리 시간의 균형을 맞춘 등급입니다. (string)","enum":["std","pro","turbo","4k","standard"],"example":"std"},"duration":{"type":"string","description":"영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다. (integer)","example":"5"},"aspect_ratio":{"type":"string","description":"출력 영상의 가로:세로 비율입니다. 예: 16:9, 9:16, 1:1. 선택한 버전·등급·모드에서 허용하는 값만 사용할 수 있으며, 다른 값은 접수 전에 거부됩니다. 가능한 값은 3가지입니다. 16:9 = 가로가 긴 와이드 비율입니다. 유튜브·TV처럼 가로 화면에 맞습니다. 9:16 = 세로로 긴 비율입니다. 숏폼·모바일 세로 화면에 맞습니다. 1:1 = 가로·세로가 같은 정사각 비율입니다. 피드·프로필 이미지에 맞습니다. (string)","enum":["16:9","9:16","1:1"]},"resolution":{"type":"string","description":"출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. 가능한 값은 6가지입니다. 720p = 가로 1280픽셀급의 HD 해상도입니다. 일반적인 웹 재생에 적합합니다. 1080p = 가로 1920픽셀급의 Full HD 해상도입니다. 화질을 우선할 때 사용하며 단가가 더 높습니다. 720P = 가로 1280픽셀급의 HD 해상도입니다. 표기만 대문자이며 720p와 같은 뜻입니다. 1080P-SR = Full HD(1080p) 입력을 초해상도(SR)로 확대한 해상도입니다. 원본보다 선명하지만 단가가 더 높습니다. 1440P-SR = QHD(1440p)급으로 초해상도(SR) 처리한 해상도입니다. Full HD보다 큰 화면에 맞고 단가가 가장 높습니다. 1080P = 가로 1920픽셀급의 Full HD 해상도입니다. 표기만 대문자이며 1080p와 같은 뜻입니다. (string)","enum":["720p","1080p","720P","1080P-SR","1440P-SR","1080P"]},"audio":{"type":"string","description":"오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. true = 오디오가 포함된 영상을 만든 경우, false = 무음 영상인 경우입니다. 제품이 오디오 생성을 지원하지 않으면 항상 false입니다. (boolean)"},"negative_prompt":{"type":"string","description":"결과에서 빼고 싶은 요소를 적습니다. 예: text, watermark, blurry. negative_prompt를 지원하지 않는 제품에서는 무시됩니다. (string)"},"cfg_scale":{"type":"string","description":"프롬프트를 얼마나 강하게 반영할지 정합니다. 0~1 범위이며, 생략하면 0.5입니다. 값이 높을수록 지시에 가깝지만 과하면 부자연스러울 수 있습니다. (number)"},"idempotency_key":{"type":"string","description":"같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요. (string)"},"image":{"type":"string","description":"분석할 이미지 파일입니다. JPG·PNG·WEBP를 지원하며, 파일 크기·해상도 제한은 요청 표를 확인하세요. (file)","format":"binary"},"last_image":{"type":"string","description":"image 모드에서 마지막 프레임 이미지 1장. multipart/form-data로 전송하며, 파일 경로가 아니라 파일 본문을 첨부합니다. (file)","format":"binary"},"reference_image":{"type":"string","description":"reference 모드 필수. 주체를 참조할 이미지 1~6장. multipart/form-data로 전송하며, 파일 경로가 아니라 파일 본문을 첨부합니다. (file)","format":"binary"},"reference_video":{"type":"string","description":"reference 모드에서 동작을 참조할 영상 0~4개. MP4·MOV·WebM, 50MB 이하. (file)","format":"binary"}},"required":["prompt"]}}}}}},"/rest/kling/jobs/{job_id}":{"get":{"summary":"Kling 영상 생성 AI","description":"3.0·o1·o3 버전과 텍스트·이미지·참조 소재 입력으로 최대 15초 영상을 만드는 생성 API","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":{"description":"영상 작업 공개 상태. 처리 단계에서 제공되는 항목만 포함합니다.","type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"model":{"type":"string","description":"요청한 영상 제품.","enum":["seedance","veo","kling"]},"version":{"type":"string","description":"선택한 제품 버전."},"mode":{"type":"string","description":"입력 방식.","enum":["text","image","reference"]},"tier":{"type":"string","description":"선택한 생성 등급."},"status":{"type":"string","description":"현재 작업 상태.","enum":["waiting","processing","completed","failed"]},"duration":{"type":"integer","description":"요청 영상 길이(초)."},"aspect_ratio":{"type":"string","description":"영상 화면 비율."},"resolution":{"type":"string","description":"영상 해상도."},"audio":{"type":"boolean","description":"오디오 생성 여부."},"point_per_second":{"type":"number","description":"접수 시 적용한 초당 포인트."},"charged_point":{"type":"number","description":"접수 시 차감한 전체 포인트."},"result_available":{"type":"boolean","description":"결과가 완료되어 다운로드 가능한지 여부."},"result_expires_at":{"type":"string","description":"결과 만료 ISO 8601 일시. 결과가 없으면 null.","nullable":true},"result_url":{"type":"string","description":"완료·미만료 상태에서만 제공되는 에이픽 결과 다운로드 주소."},"created_at":{"type":"string","description":"작업 생성 일시."},"completed_at":{"type":"string","description":"작업 완료 일시. 완료 전에는 null일 수 있습니다.","nullable":true},"error":{"type":"object","description":"실패한 작업에만 포함합니다.","properties":{"code":{"type":"string","description":"작업 실패의 공개 오류코드."},"message":{"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_VIDEO_AUTH_FAILED (401): 인증에 실패했습니다.\nAPICK_VIDEO_ACCESS_DISABLED (403): API 이용이 제한된 계정입니다.\nAPICK_VIDEO_PAYMENT_REQUIRED (403): 최소 1회 결제 후 이용할 수 있습니다.\nAPICK_VIDEO_POINTS_INSUFFICIENT (402): 사용 가능한 포인트가 부족합니다.\nAPICK_VIDEO_INVALID_REQUEST (400): 요청 내용을 확인해 주세요.\nAPICK_VIDEO_PROMPT_REQUIRED (400): prompt를 입력해 주세요.\nAPICK_VIDEO_PROMPT_TOO_LONG (400): prompt는 최대 2,000자입니다.\nAPICK_VIDEO_MODE_INVALID (400): mode는 text, image, reference 중 하나여야 합니다.\nAPICK_VIDEO_MODE_NOT_SUPPORTED (400): 이 모델에서는 지원하지 않는 mode입니다.\nAPICK_VIDEO_DURATION_INVALID (400): duration 값이 허용 범위를 벗어났습니다.\nAPICK_VIDEO_ASPECT_RATIO_INVALID (400): aspect_ratio 값이 허용 목록에 없습니다.\nAPICK_VIDEO_RESOLUTION_INVALID (400): resolution 값이 허용 목록에 없습니다.\nAPICK_VIDEO_TIER_INVALID (400): tier 값이 허용 목록에 없습니다.\nAPICK_VIDEO_VERSION_INVALID (400): 지원하지 않는 영상 모델 버전입니다.\nAPICK_VIDEO_OPTION_NOT_SUPPORTED (400): 이 모델·mode에서는 지원하지 않는 옵션입니다.\nAPICK_VIDEO_SOURCE_REQUIRED (400): 이 mode에는 입력 파일이 필요합니다.\nAPICK_VIDEO_SOURCE_TOO_MANY (400): 입력 파일 개수가 허용 범위를 초과했습니다.\nAPICK_VIDEO_SOURCE_INVALID (400): 입력 파일 형식이나 크기를 확인해 주세요.\nAPICK_VIDEO_IDEMPOTENCY_CONFLICT (409): 같은 idempotency_key에 다른 요청을 사용할 수 없습니다.\nAPICK_VIDEO_TOO_MANY_ACTIVE_JOBS (429): 동시에 진행할 수 있는 작업 수를 초과했습니다.\nAPICK_VIDEO_CONTENT_REJECTED (422): 요청한 영상을 생성할 수 없습니다. 프롬프트나 입력 파일을 확인해 주세요.\nAPICK_VIDEO_RATE_LIMITED (429): 현재 요청이 많습니다. 잠시 후 다시 시도해 주세요.\nAPICK_VIDEO_TEMPORARILY_UNAVAILABLE (503): 현재 영상 서비스를 이용할 수 없습니다. 잠시 후 다시 시도해 주세요.\nAPICK_VIDEO_TIMEOUT (408): 처리 시간이 초과됐습니다. 포인트는 환불되었습니다.\nAPICK_VIDEO_GENERATION_FAILED (500): 영상 생성에 실패했습니다. 포인트는 환불되었습니다.\nAPICK_VIDEO_JOB_NOT_FOUND (404): 작업을 찾을 수 없습니다.\nAPICK_VIDEO_JOB_CONFLICT (409): 현재 작업 상태에서는 요청을 처리할 수 없습니다.\nAPICK_VIDEO_RESULT_EXPIRED (410): 결과 보관 기간이 만료되었습니다.\nAPICK_VIDEO_RESULT_INVALID (502): 생성 결과를 확인할 수 없습니다.\nAPICK_VIDEO_BILLING_FAILED (424): 결제 원장을 완료하지 못했습니다.\nAPICK_VIDEO_INTERNAL_ERROR (500): 영상 서비스 내부 오류가 발생했습니다.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/kling/jobs/{job_id}/result":{"get":{"summary":"Kling 영상 생성 AI","description":"3.0·o1·o3 버전과 텍스트·이미지·참조 소재 입력으로 최대 15초 영상을 만드는 생성 API","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Range","in":"header","required":false,"schema":{"type":"string"},"description":"bytes=N-M, bytes=N-, bytes=-N 지원."}],"responses":{"200":{"description":"파일 직접 응답","content":{"video/mp4":{"schema":{"type":"string","format":"binary"}}}},"206":{"description":"파일 직접 응답","content":{"video/mp4":{"schema":{"type":"string","format":"binary"}}}},"416":{"description":"유효하지 않은 바이트 범위. 본문이 비어 있을 수 있습니다."},"default":{"description":"APICK_VIDEO_AUTH_FAILED (401): 인증에 실패했습니다.\nAPICK_VIDEO_ACCESS_DISABLED (403): API 이용이 제한된 계정입니다.\nAPICK_VIDEO_PAYMENT_REQUIRED (403): 최소 1회 결제 후 이용할 수 있습니다.\nAPICK_VIDEO_POINTS_INSUFFICIENT (402): 사용 가능한 포인트가 부족합니다.\nAPICK_VIDEO_INVALID_REQUEST (400): 요청 내용을 확인해 주세요.\nAPICK_VIDEO_PROMPT_REQUIRED (400): prompt를 입력해 주세요.\nAPICK_VIDEO_PROMPT_TOO_LONG (400): prompt는 최대 2,000자입니다.\nAPICK_VIDEO_MODE_INVALID (400): mode는 text, image, reference 중 하나여야 합니다.\nAPICK_VIDEO_MODE_NOT_SUPPORTED (400): 이 모델에서는 지원하지 않는 mode입니다.\nAPICK_VIDEO_DURATION_INVALID (400): duration 값이 허용 범위를 벗어났습니다.\nAPICK_VIDEO_ASPECT_RATIO_INVALID (400): aspect_ratio 값이 허용 목록에 없습니다.\nAPICK_VIDEO_RESOLUTION_INVALID (400): resolution 값이 허용 목록에 없습니다.\nAPICK_VIDEO_TIER_INVALID (400): tier 값이 허용 목록에 없습니다.\nAPICK_VIDEO_VERSION_INVALID (400): 지원하지 않는 영상 모델 버전입니다.\nAPICK_VIDEO_OPTION_NOT_SUPPORTED (400): 이 모델·mode에서는 지원하지 않는 옵션입니다.\nAPICK_VIDEO_SOURCE_REQUIRED (400): 이 mode에는 입력 파일이 필요합니다.\nAPICK_VIDEO_SOURCE_TOO_MANY (400): 입력 파일 개수가 허용 범위를 초과했습니다.\nAPICK_VIDEO_SOURCE_INVALID (400): 입력 파일 형식이나 크기를 확인해 주세요.\nAPICK_VIDEO_IDEMPOTENCY_CONFLICT (409): 같은 idempotency_key에 다른 요청을 사용할 수 없습니다.\nAPICK_VIDEO_TOO_MANY_ACTIVE_JOBS (429): 동시에 진행할 수 있는 작업 수를 초과했습니다.\nAPICK_VIDEO_CONTENT_REJECTED (422): 요청한 영상을 생성할 수 없습니다. 프롬프트나 입력 파일을 확인해 주세요.\nAPICK_VIDEO_RATE_LIMITED (429): 현재 요청이 많습니다. 잠시 후 다시 시도해 주세요.\nAPICK_VIDEO_TEMPORARILY_UNAVAILABLE (503): 현재 영상 서비스를 이용할 수 없습니다. 잠시 후 다시 시도해 주세요.\nAPICK_VIDEO_TIMEOUT (408): 처리 시간이 초과됐습니다. 포인트는 환불되었습니다.\nAPICK_VIDEO_GENERATION_FAILED (500): 영상 생성에 실패했습니다. 포인트는 환불되었습니다.\nAPICK_VIDEO_JOB_NOT_FOUND (404): 작업을 찾을 수 없습니다.\nAPICK_VIDEO_JOB_CONFLICT (409): 현재 작업 상태에서는 요청을 처리할 수 없습니다.\nAPICK_VIDEO_RESULT_EXPIRED (410): 결과 보관 기간이 만료되었습니다.\nAPICK_VIDEO_RESULT_INVALID (502): 생성 결과를 확인할 수 없습니다.\nAPICK_VIDEO_BILLING_FAILED (424): 결제 원장을 완료하지 못했습니다.\nAPICK_VIDEO_INTERNAL_ERROR (500): 영상 서비스 내부 오류가 발생했습니다.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-code-tables":[{"title":"오류 대처","columns":["코드","대처"],"rows":[["APICK_VIDEO_SOURCE_INVALID","이미지가 PNG·JPEG, 10MB 이하, 300~8,192px, 종횡비 0.4~2.5인지 확인하세요."],["APICK_VIDEO_OPTION_NOT_SUPPORTED","image 모드가 아닌데 resolution을 보냈거나, 선택한 버전·모드에서 지원하지 않는 옵션입니다."],["APICK_VIDEO_CONTENT_REJECTED","프롬프트·입력 파일·생성된 오디오가 정책(저작권·안전) 검수에서 거부됐습니다. 예약 포인트는 환불됩니다. 표현을 바꾸거나, 오디오 때문이라면 audio=false로 다시 접수하세요(지원 버전)."],["APICK_VIDEO_TOO_MANY_ACTIVE_JOBS","동시에 진행할 수 있는 작업 수를 넘었습니다. 진행 중인 작업이 끝난 뒤 접수하세요."],["APICK_VIDEO_IDEMPOTENCY_CONFLICT","같은 idempotency_key로 다른 내용을 보냈습니다. 새 작업에는 새 키를 쓰세요."],["APICK_VIDEO_TIMEOUT · APICK_VIDEO_GENERATION_FAILED","포인트는 환불됐습니다. 같은 내용으로 다시 접수할 수 있으며, 새 접수는 다시 예약 차감됩니다."],["APICK_VIDEO_RATE_LIMITED · APICK_VIDEO_TEMPORARILY_UNAVAILABLE","접수되지 않았습니다. Retry-After 헤더가 있으면 그 시간 뒤에 다시 보내세요."]]}],"x-service-errors":[{"code":"APICK_VIDEO_AUTH_FAILED","status":401,"message":"인증에 실패했습니다."},{"code":"APICK_VIDEO_ACCESS_DISABLED","status":403,"message":"API 이용이 제한된 계정입니다."},{"code":"APICK_VIDEO_PAYMENT_REQUIRED","status":403,"message":"최소 1회 결제 후 이용할 수 있습니다."},{"code":"APICK_VIDEO_POINTS_INSUFFICIENT","status":402,"message":"사용 가능한 포인트가 부족합니다."},{"code":"APICK_VIDEO_INVALID_REQUEST","status":400,"message":"요청 내용을 확인해 주세요."},{"code":"APICK_VIDEO_PROMPT_REQUIRED","status":400,"message":"prompt를 입력해 주세요."},{"code":"APICK_VIDEO_PROMPT_TOO_LONG","status":400,"message":"prompt는 최대 2,000자입니다."},{"code":"APICK_VIDEO_MODE_INVALID","status":400,"message":"mode는 text, image, reference 중 하나여야 합니다."},{"code":"APICK_VIDEO_MODE_NOT_SUPPORTED","status":400,"message":"이 모델에서는 지원하지 않는 mode입니다."},{"code":"APICK_VIDEO_DURATION_INVALID","status":400,"message":"duration 값이 허용 범위를 벗어났습니다."},{"code":"APICK_VIDEO_ASPECT_RATIO_INVALID","status":400,"message":"aspect_ratio 값이 허용 목록에 없습니다."},{"code":"APICK_VIDEO_RESOLUTION_INVALID","status":400,"message":"resolution 값이 허용 목록에 없습니다."},{"code":"APICK_VIDEO_TIER_INVALID","status":400,"message":"tier 값이 허용 목록에 없습니다."},{"code":"APICK_VIDEO_VERSION_INVALID","status":400,"message":"지원하지 않는 영상 모델 버전입니다."},{"code":"APICK_VIDEO_OPTION_NOT_SUPPORTED","status":400,"message":"이 모델·mode에서는 지원하지 않는 옵션입니다."},{"code":"APICK_VIDEO_SOURCE_REQUIRED","status":400,"message":"이 mode에는 입력 파일이 필요합니다."},{"code":"APICK_VIDEO_SOURCE_TOO_MANY","status":400,"message":"입력 파일 개수가 허용 범위를 초과했습니다."},{"code":"APICK_VIDEO_SOURCE_INVALID","status":400,"message":"입력 파일 형식이나 크기를 확인해 주세요."},{"code":"APICK_VIDEO_IDEMPOTENCY_CONFLICT","status":409,"message":"같은 idempotency_key에 다른 요청을 사용할 수 없습니다."},{"code":"APICK_VIDEO_TOO_MANY_ACTIVE_JOBS","status":429,"message":"동시에 진행할 수 있는 작업 수를 초과했습니다."},{"code":"APICK_VIDEO_CONTENT_REJECTED","status":422,"message":"요청한 영상을 생성할 수 없습니다. 프롬프트나 입력 파일을 확인해 주세요."},{"code":"APICK_VIDEO_RATE_LIMITED","status":429,"message":"현재 요청이 많습니다. 잠시 후 다시 시도해 주세요."},{"code":"APICK_VIDEO_TEMPORARILY_UNAVAILABLE","status":503,"message":"현재 영상 서비스를 이용할 수 없습니다. 잠시 후 다시 시도해 주세요."},{"code":"APICK_VIDEO_TIMEOUT","status":408,"message":"처리 시간이 초과됐습니다. 포인트는 환불되었습니다."},{"code":"APICK_VIDEO_GENERATION_FAILED","status":500,"message":"영상 생성에 실패했습니다. 포인트는 환불되었습니다."},{"code":"APICK_VIDEO_JOB_NOT_FOUND","status":404,"message":"작업을 찾을 수 없습니다."},{"code":"APICK_VIDEO_JOB_CONFLICT","status":409,"message":"현재 작업 상태에서는 요청을 처리할 수 없습니다."},{"code":"APICK_VIDEO_RESULT_EXPIRED","status":410,"message":"결과 보관 기간이 만료되었습니다."},{"code":"APICK_VIDEO_RESULT_INVALID","status":502,"message":"생성 결과를 확인할 수 없습니다."},{"code":"APICK_VIDEO_BILLING_FAILED","status":424,"message":"결제 원장을 완료하지 못했습니다."},{"code":"APICK_VIDEO_INTERNAL_ERROR","status":500,"message":"영상 서비스 내부 오류가 발생했습니다."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}