메인 콘텐츠로 건너뛰기

요약 답변

task_id을(를) 통해 작업 API를 조회하십시오. 반환된 quota이(가) 동영상의 총 비용입니다. 두 로그 항목(사전 청구 + 정산)의 합계가 이에 해당하며, “비동기 작업” 상세 보기의 quota 역시 동일한 숫자입니다.
quota ÷ 500,000 = USD. 개인 액세스 token(nap_(으)로 시작하며, sk- API 키가 아님)으로 인증하십시오. “사용량 및 개인 기록 · 읽기” 권한만 필요합니다. 생성 방법은 개인 액세스 token이란 무엇인가요?를 참조하십시오. 레거시 시스템 tokens는 2026-11-11 (UTC+8)에 폐기될 예정입니다. Log Query API를 통해 로그 항목을 하나씩 대조하려고 하지 마십시오. 두 항목 모두 task_id을(를) 포함하지 않으며, 정산 항목의 request_id은(는) 비어 있습니다.

세 숫자의 관계

Seedance 동영상은 “제출 시 선청구, 완료 시 차액 정산” 방식으로 과금되므로, 동영상 하나에 두 개의 로그 항목이 남는 반면 작업 API와 작업 상세 보기에는 단일 quota가 표시됩니다: 정산은 환불일 수도 있습니다. 빠른 480p 4초 텍스트-투-비디오 작업은 144,000이 선청구되었고, 40,594 tokens × 18.5 × 0.18 = 135,179를 사용했으므로 정산 항목에는 −8,821($0.02 환불)이 기록되며 작업 API quota는 135,179입니다. 첫 번째 숫자 세트는 참조 동영상이 있는 실제 2.0 이미지-투-비디오 작업에서 가져온 것입니다: 368,100 tokens × 14(동영상 입력 가격 책정 티어) × 0.18(그룹 비율) = 927,612, 즉 $1.86입니다. 정산 항목의 other 필드에는 final_quota = 927,612, original_quota = 224,999 및 adjustment_quota = 702,613이 포함되어 있으므로, 세 값 모두 하나의 레코드에서 확인할 수 있습니다.

상태별 실제 비용 확인

두 용어 체계는 서로 다릅니다. 동영상 조회 엔드포인트 /seedance/api/v3/.../tasks/{id}은 성공을 succeeded로 보고하는 반면, 작업 API /api/task/self은 이를 completed로 보고합니다. 폴링 코드의 조건을 그대로 복사하지 마십시오.
실패한 작업의 quota을 합산하면 사전 청구 금액이 지출로 계산됩니다. 프로그래밍 방식으로 정산을 대조할 때는 status으로 필터링하십시오. 대신 로그 조회 API를 통해 정산을 대조하는 경우 type=2과 type=11을 모두 조회해야 하며, 후자는 음수 quota이 포함된 환불 항목입니다.

매개변수 표기(로그 쿼리 API와 반대)

작업 API의 페이지 매김 매개변수는 **스네이크 케이스 page_size**이며 페이지 번호 p은 1부터 시작합니다. 로그 쿼리 API는 pageSize 카멜 케이스를 사용하며 p은 0부터 시작합니다. 잘못 사용해도 오류가 발생하지 않으며, 기본 페이지가 반환됩니다. 확인된 필터: 배치 대조를 수행하려면 시간 범위로 조회합니다. 각 항목에는 task_id, status, quota, submit_time, finish_time 및 model_name이 포함됩니다.

수동으로 로그에서 교차 확인해야 하는 경우

정산 항목 행의 세 필드는 작업 API와 일치합니다.
  • 해당 항목의 타임스탬프(created_at)는 1초 이내 오차 범위에서 작업의 finish_time과 같습니다.
  • 해당 항목의 completion_tokens는 작업의 usage.completion_tokens과 같습니다.
  • 해당 항목의 other.final_quota는 작업의 quota과 같습니다.
선청구 항목의 request_id는 제출 응답의 X-Shellapi-Request-Id 헤더와 같으므로 /api/log/self?request_id=…을 사용하여 조회할 수 있습니다. 응답에는 X-Request-Id 헤더도 포함되어 있습니다. 이는 제공업체 측 요청 ID이므로 APIYI 로그에서는 찾을 수 없습니다. 그러나 같은 초에 여러 작업이 제출되면 선청구 항목이 충돌하며, 정산 항목에는 request_id이 없으므로 로그는 개별 작업을 표본 확인하는 용도로만 적합합니다. 프로그래밍 방식의 대사에는 작업 API를 사용하십시오.

자주 묻는 질문

먼저 작업 상태를 확인하십시오. submitted / in_progress 상태인 동안에는 quota에 사전 청구액만 표시되며 두 번째 로그 항목이 아직 존재하지 않습니다. failed 상태가 되면 quota에는 여전히 사전 청구액이 표시되지만 로그에 마이너스 환불 항목이 추가되므로 두 항목의 합계는 0이 됩니다. completed 작업의 경우 두 값이 반드시 일치해야 합니다. 일치하지 않는 경우 지원팀에 task_id을(를) 보내주십시오.
정산은 작업 완료 시 게이트웨이 요청 경로 외부에서 시스템에 의해 기록되므로 token, 그룹 또는 request_id이(가) 포함되지 않으며, 콘솔에는 “스트리밍”으로 표시됩니다. 이는 정상적인 현상입니다.
/v1/videos 및 기타 일반 엔드포인트의 사전 청구 항목 content에는 task ID: cgt-…이(가) 포함되지만, 정산 항목에는 여전히 포함되지 않습니다. 또한 해당 엔드포인트들은 현재 Seedance의 해상도 파라미터도 불완전하게 전달하므로, 항상 문서화된 경로인 /seedance/api/v3/contents/generations/tasks을(를) 사용하십시오. 자세한 내용은 동영상 생성 API를 참조하십시오.
/api/task/self은(는) 해당 token을 소유한 계정의 작업만 반환합니다. 대사용 token에는 “사용량 및 개인 기록 · 읽기” 권한만 부여하고, 안전하게 보관하며, 코드 저장소에 노출되지 않도록 하십시오.

관련 문서