{"openapi":"3.0.3","info":{"title":"APICK Seedance 영상 생성 AI","version":"1.0.0","description":"1.0·1.5·2.0·2.5 버전과 텍스트·이미지·참조 영상 입력으로 최대 30초 영상을 만드는 생성 API"},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/seedance/jobs":{"post":{"summary":"Seedance 영상 생성 AI","description":"1.0·1.5·2.0·2.5 버전과 텍스트·이미지·참조 영상 입력으로 최대 30초 영상을 만드는 생성 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":"영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. 가능한 값은 4가지입니다. 2.5 = 2.5 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. 2.0 = 2.0 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. 1.5 = 1.5 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. 1.0 = 1.0 버전을 선택한 값입니다. 같은 제품이라도 버전별 지원 등급·길이·해상도·오디오·요금이 다르므로 이 문서의 버전 표와 대조하세요. (string)","enum":["2.5","2.0","1.5","1.0"]},"mode":{"type":"string","description":"입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text 가능한 값은 3가지입니다. text = 텍스트 프롬프트만으로 결과를 만드는 값입니다. 이미지 입력 없이 문장 묘사만 사용합니다. image = 이미지 1장을 첫 프레임·기준 이미지로 쓰는 값입니다. 이미지와 프롬프트를 함께 보냅니다. reference = 참조 이미지·영상을 스타일 기준으로 쓰는 값입니다. 여러 장을 보낼 수 있고, 제품별 최대 장수가 다릅니다. (string)","enum":["text","image","reference"]},"tier":{"type":"string","description":"품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. 가능한 값은 4가지입니다. standard = 표준 품질·속도 등급입니다. 대부분 제품의 기본값이며 품질과 처리 시간의 균형을 맞춘 등급입니다. fast = 빠른 생성 등급입니다. 표준보다 처리 시간이 짧고 화질은 다소 낮거나 같은 수준입니다. mini = 경량 등급입니다. 짧은 영상·낮은 해상도에 맞춘 저비용 등급입니다. pro = 상위 품질 등급입니다. 표준보다 화질·디테일이 좋고 처리 시간과 요금이 더 큽니다. (string)","enum":["standard","fast","mini","pro"]},"duration":{"type":"string","description":"영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다. (integer)","example":"5"},"aspect_ratio":{"type":"string","description":"출력 영상의 가로:세로 비율입니다. 예: 16:9, 9:16, 1:1. 선택한 버전·등급·모드에서 허용하는 값만 사용할 수 있으며, 다른 값은 접수 전에 거부됩니다. 가능한 값은 7가지입니다. 16:9 = 가로가 긴 와이드 비율입니다. 유튜브·TV처럼 가로 화면에 맞습니다. 4:3 = 가로가 약간 긴 전통적인 화면 비율입니다. 일반 사진·강의 영상에 맞습니다. 1:1 = 가로·세로가 같은 정사각 비율입니다. 피드·프로필 이미지에 맞습니다. 3:4 = 세로가 약간 긴 비율입니다. 인쇄·세로 사진에 맞습니다. 9:16 = 세로로 긴 비율입니다. 숏폼·모바일 세로 화면에 맞습니다. 21:9 = 매우 넓은 시네마 비율입니다. 영화 같은 와이드 화면에 맞습니다. adaptive = 입력 이미지·영상의 비율을 그대로 따라가는 값입니다. 원본 비율을 유지해야 할 때 쓰며, 지원 제품과 버전이 제한됩니다. (string)","enum":["16:9","4:3","1:1","3:4","9:16","21:9","adaptive"],"example":"16:9"},"resolution":{"type":"string","description":"출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. 가능한 값은 3가지입니다. 480p = 가로 854픽셀급의 낮은 해상도입니다. 용량과 속도를 우선할 때 사용합니다. 720p = 가로 1280픽셀급의 HD 해상도입니다. 일반적인 웹 재생에 적합합니다. 1080p = 가로 1920픽셀급의 Full HD 해상도입니다. 화질을 우선할 때 사용하며 단가가 더 높습니다. (string)","enum":["480p","720p","1080p"]},"audio":{"type":"string","description":"오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. true = 오디오가 포함된 영상을 만든 경우, false = 무음 영상인 경우입니다. 제품이 오디오 생성을 지원하지 않으면 항상 false입니다. (boolean)"},"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 모드에서 주체·스타일을 참조할 이미지. 기본 버전 0~30장. (file)","format":"binary"},"reference_video":{"type":"string","description":"reference 모드에서 동작을 참조할 영상. 기본 버전 0~10개. MP4·MOV·WebM. (file)","format":"binary"},"reference_audio":{"type":"string","description":"reference 모드에서 음악·목소리·효과음을 참조할 오디오. 기본 버전 0~10개. MP3·WAV. (file)","format":"binary"}},"required":["prompt"]}}}}}},"/rest/seedance/jobs/{job_id}":{"get":{"summary":"Seedance 영상 생성 AI","description":"1.0·1.5·2.0·2.5 버전과 텍스트·이미지·참조 영상 입력으로 최대 30초 영상을 만드는 생성 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/seedance/jobs/{job_id}/result":{"get":{"summary":"Seedance 영상 생성 AI","description":"1.0·1.5·2.0·2.5 버전과 텍스트·이미지·참조 영상 입력으로 최대 30초 영상을 만드는 생성 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_CONTENT_REJECTED","프롬프트·입력 파일·생성된 오디오가 정책(저작권·안전) 검수에서 거부됐습니다. 예약 포인트는 환불됩니다. 표현을 바꾸거나, 오디오 때문이라면 audio=false로 다시 접수하세요."],["APICK_VIDEO_TOO_MANY_ACTIVE_JOBS","동시에 진행할 수 있는 작업 수를 넘었습니다. 진행 중인 작업이 끝난 뒤 접수하세요."],["APICK_VIDEO_OPTION_NOT_SUPPORTED","선택한 버전·모드에서 지원하지 않는 옵션입니다. 위 버전별 표의 '추가 옵션'을 확인하세요."],["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"}}}}