2026/08/09

Seedance 2.5 콘텐츠 필터링: 거부 원인 진단하기

제출 응답, 작업 오류, 라우팅 파라미터, 확정 사용량으로 Seedance 2.5 거부를 진단하고 추측하지 말고 증거로 구분하는 방법을 배웁니다.

Seedance 2.5 요청이 실패했다면, API가 작업을 만들기 전에 페이로드를 거부했는지, 아니면 비동기로 생성된 작업이 나중에 안전성 검사를 통과하지 못했는지 먼저 구분해야 합니다. 응답에는 두 경우를 가려낼 증거가 이미 들어 있습니다.

이 가이드는 정확한 경로, 요청 필드, 작업 상태, 오류 코드, 확정 사용량을 사용해 거부를 진단합니다. 한 호스트의 동작을 다른 호스트에 적용하거나, 제한이 덜한 경로를 필터 없는 모델로 취급하지 않습니다.

TL;DR

경과 시간이 아니라 작업 생성부터 확인하세요. 동기식 400은 작업이 만들어지기 전에 요청 검증에서 실패했다는 뜻입니다. 작업이 생성된 뒤에 failed가 되었다면 error와 usage 필드로 진단해야 합니다^[2]^[3].
content_filter: false는 "필터 없음"이 아닙니다. reAPI에서는 Flexible 채널을 선택하며, 가격은 같고 상위 정책 검사도 계속 적용됩니다^[2].
오류 80006만으로는 검열 단계를 알 수 없습니다. 프롬프트, 참조 이미지나 영상, 생성 결과 중 어느 쪽이 원인일 수도 있습니다^[3].
최종 청구를 확인하세요. 실패한 작업의 usage.credits를 보면 예약 금액이 전액 환불됐는지, 생성 이후 비용이 남았는지 알 수 있습니다^[3]^[4].
알아둘 모델 사실: Seedance 2.5는 한 번에 최대 30초를 생성하며, 참조 자료로 이미지 30장, 영상 10개, 오디오 10개까지 받습니다^[1].

같은 모델이라도 접근 인터페이스에 따라 검증과 라우팅 방식이 달라질 수 있습니다. reAPI에서 content_filter는 상위 모델 파라미터가 아니라 명시적인 라우팅 제어입니다. 기본값은 true이고, API를 직접 호출할 때 false로 설정하면 제한이 덜한 Flexible 채널을 선택할 수 있습니다. 다만 검열이 꺼지는 것은 아닙니다^[2].

진단할 때는 다음 네 단계를 구분하세요:

동기식 요청 검증. 필드가 잘못됐거나 지원하지 않는 미디어를 보내면 작업 생성 전에 HTTP 오류가 반환됩니다.
경로 선택. 유효한 요청은 content_filter 같은 모델별 파라미터가 정한 채널로 전달됩니다.
비동기 작업 실행. 작업은 processing을 거쳐 completed 또는 failed가 됩니다.
안전성 실패. 80006은 프롬프트, 참조 자료, 생성 결과의 거부를 모두 나타낼 수 있으므로 코드만으로는 어느 검사가 작동했는지 구분할 수 없습니다^[3].

이는 API에서 관찰할 수 있는 단계이며, 모든 호스트의 내부 파이프라인이 동일하다는 뜻은 아닙니다.

실패 지점을 찾는 다섯 가지 확인

아래 확인은 모두 API가 노출하는 필드를 사용합니다. 일부러 금지된 프롬프트를 보낼 필요는 없습니다.

확인 1: 제출 후 작업이 생성되었는가?

POST의 HTTP 상태와 응답 본문을 저장하세요. 2xxxx 오류를 동반한 동기식 400은 작업 생성 전 요청 검증 실패입니다. 응답에 표시된 필드나 미디어 형식을 수정하세요. 응답에 작업 ID가 있다면 제출은 통과했으며 이후 진단은 작업 레코드로 진행합니다^[2]^[3].

경과 시간은 참고 정보일 뿐, 어떤 내부 구성 요소가 결정했는지는 증명하지 않습니다.

확인 2: 경로와 라우팅 필드를 기록하세요

엔드포인트, 정확한 모델 ID, 전체 페이로드, content_filter 값을 저장하세요. reAPI에서는 이 필드를 생략하면 true이고, false는 Flexible 채널을 선택합니다. 값을 기록하지 않으면 서로 다른 경로를 비교하게 될 수 있습니다^[2].

확인 3: 참조 계약을 검증하세요

소유하거나 처리 권한이 있는 참조 자료만 사용하세요. 모든 URL이 공개 HTTP(S)이고, 실제 파일 형식이 지원되며, 이미지, 영상, 오디오 개수가 문서화된 한계 내인지 확인하세요. 지원하지 않는 미디어는 동기식 400을 반환하므로 모델 검열 거부로 설명해서는 안 됩니다^[2].

확인 4: 최종 작업 오류를 확인하세요

GET /api/v1/tasks/{id}로 completed 또는 failed가 될 때까지 폴링하세요. 실패한 작업인 경우 error.code, error.message, 작업 ID, 원래 요청을 기록하세요. 코드 80006은 콘텐츠 정책 실패를 확인해주지만 프롬프트, 참조, 생성 결과 중 어느 것이 트리거했는지는 알려주지 않습니다^[3]^[4].

확인 5: 확정 사용량을 확인하세요

같은 최종 작업에서 usage.credits를 읽으세요. 0이면 예약이 환불됐다는 뜻이고, 양수면 문서화된 생성 이후 요금이 유지됐다는 뜻입니다. 오류 메시지만으로는 청구를 추론하지 마세요^[3]^[4].

오류 80006이 트리거를 특정하지 못하는 이유

공개 오류 계약은 의도적으로 여러 안전성 결과를 하나의 워크플로 코드 아래 그룹화합니다. 프롬프트, 참조 이미지, 참조 영상, 생성된 결과 중 어느 것이든 80006을 트리거할 수 있습니다^[3]. 코드는 호스트가 프롬프트를 다시 썼는지, 특정 얼굴 분류기를 실행했는지, 임계값을 변경했는지는 증명하지 않습니다.

같은 페이로드를 변경 없이 다시 보내지 마세요. 먼저 민감한 프롬프트 텍스트를 수정하고 모든 참조를 검증하세요. 모델이 지원하고 API를 직접 호출하는 경우 content_filter: false로 덜 제한적인 경로를 테스트할 수 있습니다. 다만 안전성 검토가 꺼지는 것은 아닙니다^[2]^[3].

검증 가능한 경로와 파라미터 사실

경로는 비동기입니다. POST /api/v1/videos/generations로 제출한 후 반환된 작업 ID를 유지하고, GET /api/v1/tasks/{id}로 폴링하세요. 폴링은 크레딧을 소비하지 않습니다^[2]^[4].

content_filter는 모델별 라우팅입니다. reAPI Seedance 2.5 경로에서 기본값은 true입니다. false로 설정하면 채널이 바뀌지만 가격은 같고, 그 경로에서의 실패도 가능합니다^[2].

현재 reAPI 해상도 enum은 480p, 720p, 1080p입니다. 반환된 파일을 확인한 후 재판매자의 더 넓은 해상도 레이블에 의존하세요^[2].

참조 한계는 명시되어 있습니다. 모델은 이미지 30장, 영상 10개, 오디오 10개까지 받으며, ByteDance도 런칭 자료에서 동일한 멀티모달 참조 용량을 설명합니다^[1]^[2].

ByteDance Seed. One-take Creation, Flexible Referencing: Introducing Seedance 2.5. Published 31 July 2026, retrieved August 2026 from seed.bytedance.com/en/blog/one-take-creation-flexible-referencing-introducing-seedance-2-5
reAPI. Seedance 2.5 API — route, request parameters, reference limits, content_filter, task flow, and refund behavior. Retrieved August 2026 from reapi.ai/docs/seedance-2-5
reAPI. API errors — validation codes and 80006 content-policy handling. Retrieved August 2026 from reapi.ai/docs/api/errors
reAPI. Tasks API — status, settled usage, polling, and output contract. Retrieved August 2026 from reapi.ai/docs/api/tasks