본문으로 건너뛰기
사용 문서

문서 검색

검색은 브라우저 안에서만 이루어지며 검색어를 전송하거나 저장하지 않습니다. 인증 정보를 입력하지 마세요.

검색 색인을 불러오는 중…

Tab 또는 방향키로 이동 · Enter로 열기 · Esc로 닫기
문서 탐색

MCP 지출 안전장치

구체적 사용자 승인, 견적 만료·가격 변경 처리, 멱등성 유지로 허용 지출을 몰래 늘리지 않도록 하세요.

공개 베타최종 확인
이 페이지의 내용

인증은 지출 승인이 아닙니다

공식 MCP는 공개 베타입니다. 이 안전장치는 AI가 대신 수행하는 호출을 포함한 실제 호출에 적용됩니다.

OAuth 권한은 계정의 작업을 허용할 뿐 모든 향후 생성을 승인하지 않습니다. generate_animation은 유료이며 상태를 변경합니다. 먼저 입력, 설정, 출력, 예상 비용을 설명하고 승인을 받으세요.

도구 주석은 클라이언트의 안전 참고 사항이지 동의·서버 강제 검사의 대체물이 아닙니다. cancel_animation도 상태를 변경하므로 연결 테스트만을 위해 작업을 취소하지 마세요.

두 가지 서버 안전장치

  • quote_id: 현재 사용자·OAuth 클라이언트 소유의 단기 견적입니다. 생성 시 가격 관련 매개변수, 현재 가격, 만료, 하나의 논리 생성 키에 대한 결합을 검증합니다.
  • max_credits: 현재 생성 견적에 적용되는 명시적인 0 이상의 상한입니다.

최소 하나가 필수이며 함께 제공할 수 있습니다. 둘 다 무제한 작업의 반복 예산은 아닙니다. 새 작업을 반복하면 작업별 상한 아래에서도 계속 지출할 수 있습니다.

가격 계산에 없는 필드라도 승인된 요청 그대로 유지하세요. 사용자 의도에는 가격뿐 아니라 이미지·프롬프트도 포함됩니다.

거부되면 생성을 중단

오류 올바른 다음 단계
SPEND_CONFIRMATION_REQUIRED 승인받고 견적 또는 명시적 상한 제공
QUOTE_EXPIRED 재견적 후 변경 금액을 보여 주고 승인
QUOTE_MISMATCH 바뀐 생성·내보내기 설정 확인
QUOTE_CHANGED 새 가격을 보여 주고 승인 요청
QUOTE_ALREADY_USED 새 작업에 재사용하지 말고 원래 작업 복구
CREDIT_LIMIT_EXCEEDED 중단 후 범위 축소 또는 다른 상한 승인 요청
INSUFFICIENT_CREDITS 잔액 문제 보고; 자동 구매 금지

거부를 “고치기” 위해 상한 삭제·몰래 증가, 계정 전환, 이미지 변경, 새 멱등 키 생성을 하지 마세요.

재시도 및 취소

생성 전 승인 요청과 idempotency_key를 저장하세요. 시간 초과가 아무 일도 없었음을 뜻하지는 않습니다. 원래 논리 키·요청으로 복구한 뒤 ID로 조회하세요. AI 재연결·재시작이 기본적으로 새 생성을 만들게 하지 마세요.

중복 방지 범위에는 사용자, 작업 종류, OAuth 클라이언트가 포함됩니다. 동일 멱등 문자열이라도 클라이언트 전환은 불확실한 생성의 안전한 재시도가 아닙니다. 같은 클라이언트의 접근 토큰 갱신 자체는 클라이언트 식별을 바꾸지 않습니다.

원하는 출력이 바뀌면 갱신 견적·적절한 승인이 필요한 새 결정으로 처리하세요. 종료 실패는 사용 가능한 출력부터 확인하고 재시도하세요.

취소는 최선 노력이며 수행한 작업은 과금될 수 있습니다. 종료 상태를 기다려 실제 크레딧과 유용한 에셋을 보고하세요.

출력·내보내기 전 Seedance 콘텐츠 심사 거부가 확인되면 원클릭 전체 크레딧이 반환됩니다. credits.refunded, credits.released, 순차감 credits.charged를 보고하세요. 기록 전 반환을 약속하거나 반환분을 새 생성 승인으로 취급하지 마세요. 계정·결제 예외는 검토가 필요할 수 있습니다.

유용하되 비공개인 기록 유지

작업 ID, 에셋 ID, 승인 상한, 오류 코드, 요청 ID를 적절한 비공개 앱 상태에 보관하세요. API 키, OAuth 토큰, Base64 이미지, 서명 업로드·다운로드 URL, 비공개 프롬프트를 분석에 내보내지 마세요.

API 호출자는 MCP 전용 매개변수를 POST /animations에 복사하지 마세요. 서로 다른 견적 의미는 API 빠른 시작에 설명되어 있습니다.

이 문서가 도움이 되었나요?

검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침

도움이 필요하신가요? 지원팀 문의