GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
모든 가이드

· reAPI Team

API 500 오류: 동영상 요청을 재시도해야 하는 경우

API 500 오류를 처리하면서 유료 동영상 작업이 중복되지 않도록 하세요. 제출이 수락되었는지 확인하고, 작업 ID를 복구하고, 재시도를 제한해 워크플로를 안전하게 재개하세요.

API 500 오류: 동영상 요청을 재시도해야 하는 경우

한 번 클릭하고 오류 메시지가 표시된 다음 다시 클릭합니다. 동영상 애플리케이션에서는 화면에 실패로 표시되는 동안 유료 생성 작업이 두 개 만들어질 수 있습니다.

가상의 요청을 생각해 보겠습니다. 서버가 첫 번째 제출을 수락하고 작업을 시작하지만 응답이 클라이언트로 돌아오는 도중 사라집니다. 클라이언트는 오류를 받고 다시 제출합니다. 엔드포인트가 수락된 제출마다 새 작업을 만든다면 두 작업이 모두 계속 진행될 수 있습니다. 두 번째 클릭은 첫 번째 응답을 복구한 것이 아니라 다른 동영상을 요청한 것입니다.

이것이 API 500 오류의 실질적인 어려움입니다. AWS의 재시도 지침은 응답 실패나 시간 초과만으로 작업에 부작용이 없었다고 단정할 수 없다고 경고합니다.[1] 생성을 재시도하기 전에 실패한 요청이 무엇을 하고 있었는지, 수락되었다는 증거가 남아 있는지 확인하세요.

실패한 요청 찾기

“Request failed with status code 500” 같은 메시지는 HTTP 결과를 나타낼 뿐 동영상 상태를 알려 주지는 않습니다. MDN은 500을 요청을 이행하지 못하게 한 예상치 못한 서버 상태로 정의합니다.[2] 어느 구성 요소에서 실패했는지 알려 주지 않으며, 모든 입력이 유효했음을 증명하거나 기다리면 해결된다고 보장하지도 않습니다.

클라이언트 로그에서 메서드와 URL을 확인하세요. 생성 POST 실패와 기존 작업을 가져오는 중 발생한 실패는 결과가 다릅니다. 앞의 두 작업이 모두 성공한 뒤 파일 다운로드만 실패할 수도 있습니다. 이 세 경우를 모두 “생성 실패”로 묶는 인터페이스는 복구에 필요한 차이를 없앱니다.

UTC 시간, 모델, 상태, 응답 본문, 사용 가능한 요청 또는 작업 식별자를 기록하세요. 로그를 공유하기 전에 인증 정보를 삭제하세요. 응답이 문서화된 API 오류 형식이 아니라 HTML이라면 그 사실도 남기세요. 일반 오류 페이지에서 모델 실패를 추측하지 마세요.

가상의 첫 번째 클릭에서 확인할 것은 작업 ID가 있는지 여부입니다. 서버에 저장된 제출 응답, 관련 워크플로 출력, 문서화된 콜백 기록을 찾아보세요. 실제로 요청을 보낸 계정이나 프로젝트를 확인하세요. 다른 대시보드 계정으로는 이 제출이 작업을 만들었는지 판단할 수 없습니다.

작업 ID가 있으면 해당 작업부터 이어서 진행하세요

식별자를 복구했다면 제공업체가 문서화한 읽기 작업을 사용하세요. reAPI에서 GET /api/v1/tasks/{id}는 크레딧을 소모하지 않고 작업을 가져옵니다.[3] 이후 상태를 관찰할 때 이 작업을 사용하세요. 원래 생성 요청 본문을 다시 보내면 별도의 제출이 생성됩니다.

응답에서 작업 상태를 확인하세요. reAPI는 작업을 찾으면 HTTP 200을 반환하며, 해당 작업의 상태가 failed인 경우에도 마찬가지입니다.[4] 따라서 HTTP 200이 동영상 성공을 뜻하지는 않습니다. 마찬가지로 조회에서 500이 반환되어도 동영상이 실패했다는 뜻은 아닙니다. 조회로 사용할 수 있는 답을 얻지 못했다는 의미입니다.

완료된 작업은 문서화된 출력 필드를 사용해 처리하세요. 애플리케이션이 두 번째 생성을 기다리게 두지 말고 필요한 파일을 저장하세요. 처리 중인 작업은 계속 관찰하세요. 실패한 작업은 새 시도가 타당한지 결정하기 전에 오류와 정산 정보를 확인하세요.

실패한 작업과 청구는 서로 관련되어 있지만 별개의 문제입니다. reAPI는 실패 작업의 환불을 문서화하고 있으며, 일부 모델에서는 생성 후 안전 검사가 과금 가능한 생성이 발생한 뒤 출력을 차단할 수 있습니다.[3] 실제 작업의 사용량 기록을 보존하세요. 일반적인 “서버 오류” 배너만으로 모든 요금이 사라져야 한다고 판단할 수는 없습니다. 실패한 생성의 청구 처리는 종료 상태의 작업과 적용되는 정책을 기준으로 판단해야 합니다.

ID가 없으면 수락 여부를 미확정으로 남겨 두세요

더 까다로운 경우는 첫 번째 클릭에 사용할 수 있는 제출 응답이 없는 상황입니다. 애플리케이션에서 해당 작업을 명시적인 미확정 상태로 두세요. 예를 들어 내부 acceptance_unknown 값은 전송되지 않은 작업 및 제공업체가 실패를 확인한 작업과 구분할 수 있습니다. 이는 애플리케이션 상태의 제안이며 모든 API가 반환하는 필드는 아닙니다.

안정적인 로컬 작업 ID를 유지하고 복구 담당자를 지정하세요. 담당자는 통합 기능이 실제로 제공하는 증거, 즉 저장된 응답, 콜백, 권한이 부여된 작업 기록 또는 지원팀의 확인 결과를 대조할 수 있습니다. 나중에 작업을 식별하면 원래 작업에 연결하고 그 지점부터 이어서 진행하세요.

로컬 작업 ID 열이 비어 있다는 사실은 애플리케이션이 ID를 저장하지 않았다는 것만 증명합니다. 수락된 뒤 응답이 사라졌을 수도 있습니다. 마찬가지로 로컬 작업 ID가 제공업체에 자동으로 전달되거나 생성 엔드포인트가 요청을 중복 제거하게 만들지는 않습니다. 증거를 정리하는 데는 도움이 되지만 정확히 한 번 실행되었다는 증거는 아닙니다.

Idempotency-Key 헤더도 신중하게 다루세요. HTTP POST는 본질적으로 멱등이 아니며, 반복 요청의 안전성은 엔드포인트의 실제 계약에 달려 있습니다.[5] reAPI는 이 헤더를 기록하지만 생성 요청의 중복 제거에는 사용하지 않는다고 명시합니다. 수락된 POST를 같은 키로 반복하면 다른 작업과 추가 요금이 발생할 수 있습니다.[6]

증거가 여전히 불분명하더라도 의도적으로 대체 작업을 만드는 것이 업무상 판단일 수 있습니다. 원래 미확정 작업과 연결된 별도의 시도로 기록하고 두 작업이 모두 완료될 가능성을 고려하세요. 재시도 대기열을 단순하게 만들려고 첫 번째 시도를 조용히 “생성되지 않음”으로 바꾸지 마세요. 그러면 늦게 결과나 요금이 도착했을 때 필요한 기록이 사라집니다.

n8n이 무엇을 다시 실행하는지 확인하세요

워크플로 편집기에서는 같은 모호성을 놓치기 쉽습니다. “Generate Video”라고 표시된 노드가 작업을 제출한 뒤 결과를 기다릴 수 있습니다. 노드가 빨간색으로 표시되는 것은 대기 시간이 끝났다는 뜻일 수 있으며, 원격 예측 작업은 계속 실행 중일 수 있습니다.

WaveSpeed의 공식 n8n 통합 문서는 정확히 이러한 동작을 설명합니다. 생성 노드는 예측 작업을 제출하고 결과를 기다립니다. 양수 시간 초과를 설정하면 예측 작업이 계속 실행 중이어도 노드가 실패할 수 있습니다. 문서는 n8n의 Retry On Fail이 노드 전체를 다시 실행하여 별도로 과금되는 새 예측 작업을 만든다고 경고합니다. 일시적인 폴링 실패는 이미 내부에서 재시도됩니다.[7] 이 경고는 이 통합에 적용되며 모든 커뮤니티 노드에 자동으로 적용되지는 않습니다.

HTTP Request 노드로 만든 워크플로에서는 재시도가 설정된 노드의 동작을 살펴보세요. n8n은 Retry on Fail이 노드 수준 설정이라고 설명합니다.[8] 그 노드가 생성 POST를 보내면 다시 시도할 때 해당 POST를 또 보냅니다. 알려진 작업을 읽기만 한다면 반복되는 동작은 읽기입니다. 워크플로에 표시된 오류 텍스트만으로 노드를 확인하는 일을 대신할 수는 없습니다.

실용적인 설계 방법은 제출과 폴링 사이에 수락된 작업 ID를 영속적으로 저장하는 것입니다. 그러면 생성 단계를 다시 거치지 않고 읽기 단계부터 복구할 수 있습니다. 이 방법으로는 앞에서 설명한 제출 응답 손실 사례가 해결되지 않습니다. 해당 미확정 경로는 별도로 유지하세요. 전체 실행을 수동으로 다시 실행하는 경우에도 앞서 성공한 생성 단계가 다시 실행될 수 있으므로 동일한 점검이 필요합니다.

가상의 이중 클릭 사례로 돌아가 보겠습니다. 두 번째 클릭을 자동 노드 재시도로 바꿔도 청구 문제는 달라지지 않습니다. 애플리케이션은 원래 작업을 확인하는 것인지 새 작업을 요청하는 것인지 알아야 합니다.

중단 지점을 정해 읽기를 재시도하세요

알려진 작업을 읽는 중 발생한 일시적 실패는 비교적 재시도하기 쉬운 경우입니다. 같은 작업 식별자를 사용하고 엔드포인트에 문서화된 폴링 및 속도 제한 규칙을 따르세요. 허용된 시도 횟수나 경과 시간 예산이 소진되면 즉시 반복하는 루프를 멈추세요.

AWS는 불안정한 종속 서비스에 과도한 요청을 보내지 않도록 상한이 있는 지수 백오프, 지터, 시도 횟수 제한을 설명합니다.[1] 지터는 모든 클라이언트의 다음 시도를 같은 순간에 예약하지 않고 분산합니다. 이러한 기법은 재시도 부하를 관리하지만 생성 POST를 중복 제거되는 작업으로 바꾸지는 않습니다.

복구를 담당할 계층을 하나 정하세요. SDK, 워크플로 노드, 바깥쪽 작업자가 각각 독립적으로 반복하면 실제 트래픽이 바깥쪽 설정에서 예상하는 양을 초과할 수 있습니다. 또 다른 반복 루프를 추가하기 전에 통합 기능에 이미 내장된 재시도를 확인하세요.

읽기 예산이 끝나면 나중에 대조할 수 있도록 작업 ID를 보존하세요. 클라이언트 기한은 해당 클라이언트가 얼마나 기다렸는지를 나타냅니다. 문서화된 취소 작업이 성공하지 않았다면 원격 생성이 중단되었다는 뜻은 아닙니다. 새 작업을 제출하는 조건 없는 “다시 시도” 버튼을 제공하는 대신 결과 조회가 미확정 상태임을 표시하세요.

대체 작업을 선택하기 전에 구체적인 오류를 확인하세요

구조화된 오류를 받으면 오류 코드와 문서화된 적용 범위를 확인하세요. 예를 들어 reAPI는 60001 및 60002를 작업을 저장하거나 워크플로를 시작하지 못한 경우로 지정하고 크레딧을 환불한다고 설명합니다.[4] 이렇게 문서화된 경우는 알 수 없는 HTML 500 응답이나 제출 후 연결이 끊긴 경우와 다른 복구 결정을 뒷받침합니다. 이 환불 처리를 모든 서버 오류에 확대 적용하지 마세요.

구체적인 응답에 유효하지 않은 입력이나 사용할 수 없는 미디어가 표시되면, 다른 시도를 제출하기 전에 해당 엔드포인트 문서에 따라 지적된 문제를 수정하세요. 원래 시도의 증거를 보존하고 수정된 제출은 새 작업으로 취급하세요. 입력을 바꾼다고 이전 요청의 수락 여부가 미확정인 문제가 해결되지는 않습니다.

HTTP 상태와 응답 세부 정보가 없으면 “서버가 현재 이 요청을 처리할 수 없습니다”라는 문구도 충분하지 않습니다. 프롬프트를 반복해서 바꾸거나 브라우저를 새로 고치거나 시간 초과를 늘려도 서버 측 실패가 어디서 발생했는지 알 수 없습니다. 제공업체가 관리하는 엔드포인트라면 해당 지원 절차를 통해 메서드, URL, UTC 시간 및 사용 가능한 식별자를 제공하세요. reAPI의 오류 가이드에는 이 증거가 명시되어 있습니다.[4]

다른 제공업체가 지원하는 입력, 출력 및 운영 조건이 작업에 맞으면 유용한 대체 서비스가 될 수 있습니다. 하지만 호스트 이름이 다르다는 사실만으로 실패 경로가 독립적이라고 증명되지는 않습니다. 대체 서비스가 성공했다고 해서 원래 제출에서 무슨 일이 있었는지도 밝혀지지 않습니다. 나중에 완료되는 원래 작업을 포함해 두 시도를 모두 확인할 수 있게 유지하세요.

밀린 작업을 재개하기 전에 이미 전송된 작업을 파악하세요. 알려진 작업은 계속 관찰하거나 결과를 기록해야 합니다. 알 수 없는 제출에는 담당자를 지정하고 대체 작업을 만들지 명시적으로 결정해야 합니다. 첫 번째 재시도가 성공하면 유용하지만, 각 사용자 요청에 대해 어떤 원격 작업이 존재할 수 있는지 설명할 수 있어야 복구 과정을 이해할 수 있습니다.

참고 자료

  1. AWS Builders Library: 타임아웃, 재시도 및 지터를 적용한 백오프. 2019년에 처음 게시된 엔지니어링 지침으로, 부작용, 제한된 재시도 및 재시도 증폭을 다룹니다.
  2. MDN: HTTP 500 Internal Server Error. 정의 및 서버 측 조사.
  3. reAPI Tasks. 폴링, 상태, 출력 및 정산 의미.
  4. reAPI Errors. 구체적인 실패 코드와 지원에 필요한 증거. 여기의 재시도 결정에는 참고 자료 6의 제출 계약도 적용됩니다.
  5. MDN: 멱등성. HTTP 메서드의 의미와 반복 요청이 안전하다고 가정하는 데 따르는 한계.
  6. reAPI API 개요. 생성 제출과 Idempotency-Key 계약.
  7. WaveSpeed 공식 n8n 통합 문서. 노드 시간 초과, 노드 전체 재시도 및 별도로 과금되는 예측 작업. 2026년 11월 15일에 확인.
  8. n8n 공식 HTTP Request 일반 문제 문서. Retry on Fail 및 노드 재시도 설정. 2026년 11월 15일에 확인.
모든 가이드