簡短回答
用任務介面按task_id 查,返回的 quota 就是這條影片的總消費。 日誌裡的兩條記錄(預扣 + 結算)相加等於它,「非同步任務」頁詳情裡的 quota 也是它。
quota ÷ 500,000 = 美元。認證用系統令牌(不是 sk- 開頭的 API Key),獲取方式見日誌查詢 API。
不要試圖用日誌查詢 API 逐單配對:兩條日誌記錄裡都沒有 task_id,結算那條連 request_id 都是空的。
三個數字是什麼關係
Seedance 影片按「提交時預扣、完成後多退少補」計費,所以一條影片會在日誌裡留下兩條記錄,而任務介面 / 任務詳情頁只有一個quota:
結算也可能是退回:一條 fast 480p 4 秒文生影片預扣 144,000,實際 40,594 tokens × 18.5 × 0.18 = 135,179,結算行記 −8,821(退回 $0.02),任務介面
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,三者在一條記錄裡都能看到。
按 status 判斷真實消費
注意兩套詞表不同:影片查詢介面
/seedance/api/v3/.../tasks/{id} 的成功狀態是 succeeded,任務介面 /api/task/self 的成功狀態是 completed,別把輪詢程式碼裡的判斷條件直接搬過來。
引數寫法(與日誌 API 相反)
任務介面的分頁引數是下劃線page_size、頁碼 p 從 1 開始;日誌 API 是駝峰 pageSize、p 從 0 開始。寫錯不報錯,只會退回預設分頁。
已驗證可用的過濾引數:
批次對賬時按時間窗拉取即可,每條都帶
task_id、status、quota、submit_time、finish_time、model_name:
如果一定要在日誌里人工核對
結算行有三個欄位能對上任務介面:- 「時間」(
created_at)等於任務的finish_time,相差不超過 1 秒 completion_tokens等於任務的usage.completion_tokensother.final_quota等於任務的quota
request_id 等於提交響應頭裡的 X-Shellapi-Request-Id,可以用它反查(/api/log/self?request_id=…)。注意響應頭裡另有一個 X-Request-Id,那是原廠的請求 ID,在 API易 日誌裡搜不到。但同一秒批次提交多條任務時預扣行會撞在一起,而且結算行沒有 request_id,所以日誌只適合人工核對個別任務,程式化對賬請走任務介面。
常見問題
任務詳情頁的 quota 和日誌兩條相加不一樣?
任務詳情頁的 quota 和日誌兩條相加不一樣?
先看任務狀態。
submitted / in_progress 時 quota 只是預扣,還沒有第二條日誌;failed 時 quota 仍是預扣額,而日誌裡多了一條負數退款行,兩條相加為 0。completed 狀態下兩者一定相等,若不等請把 task_id 發給客服核查。結算那條日誌為什麼沒有令牌、沒有 request_id?
結算那條日誌為什麼沒有令牌、沒有 request_id?
結算是任務完成時由系統補記的,不經過閘道請求鏈路,所以不帶令牌、分組和
request_id,控制台上還會標成「流式」。這是正常現象,不代表異常。通用影片端點提交的任務,日誌裡有 task_id 嗎?
通用影片端點提交的任務,日誌裡有 task_id 嗎?
走
/v1/videos 等通用端點時,預扣行的 content 裡會帶 任務ID: cgt-…,但結算行仍然沒有。而且這些端點目前對 Seedance 的解析度引數透傳不完整,請一律走文件路徑 /seedance/api/v3/contents/generations/tasks,見影片生成 API。系統令牌能看到別人的任務嗎?
系統令牌能看到別人的任務嗎?
/api/task/self 只返回本賬號的任務。系統令牌等價於賬號憑證,請像保管密碼一樣保管,不要寫進程式碼倉庫。