업로드 및 생성 문제 해결

실패 단계부터 확인

선택 계정·작업 공간, 대략적인 시간, 표시된 오류 코드, 알려진 작업 ID를 보관하세요. 비공개 이미지, 인증 정보, 서명 URL을 공개하지 마세요.

업로드 실패, 생성 요청 거부, 접수 후 작업 실패에는 다른 대응이 필요합니다. 시간 초과 후에는 새 생성 전에 작업 기록이나 저장한 ID를 확인하세요.

업로드 문제

MCP 로컬 이미지는 prepare_image_upload와 complete_image_upload 사이에 클라이언트가 실제 바이트를 전송해야 합니다. 선언 크기는 원본과 일치해야 합니다. 로컬 경로를 HTTP URL이나 이미지 파일 ID로 보내지 마세요.

웹과 공개 API는 비슷한 검증 실패에도 다른 응답 구조·코드를 사용할 수 있습니다. 현재 상세 오류와 공개 오류 참고를 읽으세요.

미지원 입력 또는 모델 매개변수

모드, 모델, 해상도, 길이 변경 후 기능을 다시 조회하세요. 총 참조 수, 선택 필드 지원, 프롬프트 요구 사항을 확인하세요.

ALPHA_REQUIRED에서는 참여 이미지 모두를 검사하세요. 완전히 불투명한 알파 PNG나 그려진 체크무늬는 유의미한 투명도가 아닙니다. 첫·마지막 프레임은 두 장 모두, 참조 모드는 모든 참조가 요건을 충족해야 합니다.

검증을 위해 매개변수를 바꾸면 요청·견적이 달라집니다. AI가 필수 끝 이미지를 몰래 제거하거나 더 비싼 모델을 선택하거나 크레딧 상한을 우회해서는 안 됩니다.

접수됐지만 멈춘 것처럼 보이는 작업

queued, running, cancelling은 종료 상태가 아닙니다. 제한된 간격·기한으로 조회하고 생성을 반복 클릭하지 마세요. 로컬 대기 기한이나 브라우저 종료는 접수된 작업을 취소하지 않습니다.

failed, cancelled 종료 상태이면 오류·출력을 읽으세요. 제공업체 실패와 후속 내보내기 실패는 다릅니다. 후자에는 원본 동영상이 이미 있을 수 있습니다.

취소는 최선 노력 방식입니다. 실패·취소 작업이 무료였다고 약속하지 말고 실제 크레딧 내역을 보고하세요.

생성 성공 후 품질 문제

팔다리 잘림은 원본 구도와 입력 캔버스, 외형 불일치는 단순화한 참조 이미지·프롬프트를 확인하세요. 루프 연결이나 불필요한 멈춤은 고급 편집기의 프레임 선택을 확인하세요.

적절하면 보관된 동작을 다른 내보내기에 재사용하세요. 새 AI 생성은 새 유료 결정이며 기본 문제 해결 단계가 아닙니다.

간결하고 안전한 지원 요청

오류 코드, 가능한 요청 ID, 작업 ID, 시간, 실패 단계를 비공개로 보내세요. 사용 가능한 원본 동영상·부분 출력 유무도 포함하세요. 토큰, 비공개 자료가 포함된 프롬프트, 이미지 본문, 서명 링크는 가리세요.