{"openapi":"3.0.3","info":{"title":"APICK Veo 영상 생성 AI","version":"1.0.0","description":"3.1 standard·fast·lite와 텍스트·이미지·참조 이미지 입력으로 4·6·8초 영상을 만드는 생성 API"},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/veo/jobs":{"post":{"summary":"Veo 영상 생성 AI","description":"3.1 standard·fast·lite와 텍스트·이미지·참조 이미지 입력으로 4·6·8초 영상을 만드는 생성 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.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. 이 경로에서는 항상 \"3.1\" 하나만 오는 고정값입니다. (string)","enum":["3.1"]},"mode":{"type":"string","description":"입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text 가능한 값은 3가지입니다. text = 텍스트 프롬프트만으로 결과를 만드는 값입니다. 이미지 입력 없이 문장 묘사만 사용합니다. image = 이미지 1장을 첫 프레임·기준 이미지로 쓰는 값입니다. 이미지와 프롬프트를 함께 보냅니다. reference = 참조 이미지·영상을 스타일 기준으로 쓰는 값입니다. 여러 장을 보낼 수 있고, 제품별 최대 장수가 다릅니다. (string)","enum":["text","image","reference"]},"tier":{"type":"string","description":"품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. 가능한 값은 3가지입니다. standard = 표준 품질·속도 등급입니다. 대부분 제품의 기본값이며 품질과 처리 시간의 균형을 맞춘 등급입니다. fast = 빠른 생성 등급입니다. 표준보다 처리 시간이 짧고 화질은 다소 낮거나 같은 수준입니다. lite = 가장 가벼운 등급입니다. 해상도·길이 등 지원 범위가 좁고 단가가 가장 낮습니다. (string)","enum":["standard","fast","lite"]},"duration":{"type":"string","description":"영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다. (integer)","example":"8"},"aspect_ratio":{"type":"string","description":"출력 영상의 가로:세로 비율입니다. 예: 16:9, 9:16, 1:1. 선택한 버전·등급·모드에서 허용하는 값만 사용할 수 있으며, 다른 값은 접수 전에 거부됩니다. 가능한 값은 2가지입니다. 16:9 = 가로가 긴 와이드 비율입니다. 유튜브·TV처럼 가로 화면에 맞습니다. 9:16 = 세로로 긴 비율입니다. 숏폼·모바일 세로 화면에 맞습니다. (string)","enum":["16:9","9:16"]},"resolution":{"type":"string","description":"출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. 가능한 값은 3가지입니다. 720p = 가로 1280픽셀급의 HD 해상도입니다. 일반적인 웹 재생에 적합합니다. 1080p = 가로 1920픽셀급의 Full HD 해상도입니다. 화질을 우선할 때 사용하며 단가가 더 높습니다. 4k = 가로 3840픽셀급의 4K UHD 해상도입니다. 가장 선명하지만 파일 용량과 단가가 가장 큽니다. (string)","enum":["720p","1080p","4k"],"example":"1080p"},"audio":{"type":"string","description":"오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. true = 오디오가 포함된 영상을 만든 경우, false = 무음 영상인 경우입니다. 제품이 오디오 생성을 지원하지 않으면 항상 false입니다. (boolean)"},"negative_prompt":{"type":"string","description":"결과에서 빼고 싶은 요소를 적습니다. 예: text, watermark, blurry. negative_prompt를 지원하지 않는 제품에서는 무시됩니다. (string)"},"seed":{"type":"string","description":"같은 결과를 다시 만들기 위한 시드입니다. 같은 프롬프트·설정에서 시드가 같으면 비슷한 결과가 나오며, 생략하면 매번 달라집니다. (integer)"},"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~3장. multipart/form-data로 전송하며, 파일 경로가 아니라 파일 본문을 첨부합니다. (file)","format":"binary"}},"required":["prompt"]}}}}}},"/rest/veo/jobs/{job_id}":{"get":{"summary":"Veo 영상 생성 AI","description":"3.1 standard·fast·lite와 텍스트·이미지·참조 이미지 입력으로 4·6·8초 영상을 만드는 생성 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/veo/jobs/{job_id}/result":{"get":{"summary":"Veo 영상 생성 AI","description":"3.1 standard·fast·lite와 텍스트·이미지·참조 이미지 입력으로 4·6·8초 영상을 만드는 생성 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_DURATION_INVALID","duration은 4·6·8만 됩니다. reference 모드나 1080p·4k이면 8로 보내세요."],["APICK_VIDEO_CONTENT_REJECTED","프롬프트·입력 파일·생성된 오디오가 정책(저작권·안전) 검수에서 거부됐습니다. 예약 포인트는 환불됩니다. 표현을 바꾸거나, 오디오 때문이라면 audio=false로 다시 접수하세요(지원 버전)."],["APICK_VIDEO_TOO_MANY_ACTIVE_JOBS","동시에 진행할 수 있는 작업 수를 넘었습니다. 진행 중인 작업이 끝난 뒤 접수하세요."],["APICK_VIDEO_OPTION_NOT_SUPPORTED","선택한 버전·모드에서 지원하지 않는 옵션입니다(예: cfg_scale). 위 버전별 표의 '추가 옵션'을 확인하세요."],["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"}}}}