Seedance 견적 및 결제 영수증
인증된 영구 결제 영수증을 통해 Seedance 생성 비용을 추정하고 최종 차감을 확인합니다.
Seedance 견적 및 결제 영수증
seedance-2.0, seedance-2.5, seedance-2.0-fast, seedance-2.0-mini에 적용되며, 모든 생성 채널을 대상으로 합니다. Base URL: https://apimaster.ai/v1 (https://apimaster.ai/v1). 모든 요청은 Authorization: Bearer YOUR_API_KEY로 인증합니다.
견적 obtain하기
POST https://apimaster.ai/v1/videos/quote은 표준 비디오 생성 요청과 동일한 JSON 파라미터를 받으며, model, prompt, duration, resolution, video_urls 및 기타 지원되는 생성 설정을 포함합니다. 초안 생성, 초안 업그레이드, 리믹스 견적은 현재 지원되지 않습니다.
curl "https://apimaster.ai/v1/videos/quote" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"seedance-2.0","prompt":"A paper boat on a pond","duration":4,"resolution":"480p","generate_audio":false}'
응답에는 object: "video.quote", quote_id, expires_at(Unix 초), binding: false, funds_reserved: false, 그리고 아래에서 설명하는 billing 객체가 포함됩니다. 견적의 권고 유효기간은 5분입니다. funds를 차감하거나, 작업을 생성하거나, 제공자 생성을 시작하지 않습니다. 따라서 billing.reserved_amount는 "0.000000"입니다. 견적 ID는 정보용이며, 승인 토큰이나 가격 잠금 토큰이 아니므로 생성 시 제출할 필요가 없습니다.
요금은 실제 제출 시점에 다시 계산되어 해당 작업에 대해 고정됩니다. 견적은 최대 청구액 보증이 아닙니다. 완료된 작업의 실제 비용은 견적보다 많거나 적을 수 있습니다. 자동 길이 요청은 30초 출력으로 추정되며, requested_output_seconds는 -1입니다.
생성은 여전히 제공자의 검증을 거칩니다. Seedance 2.5 비디오 확장 요청의 경우 aspect_ratio: "adaptive"를 명시적으로 설정하십시오. 제공자에 의한 거부는 일반적인 환불 라이프사이클로 처리됩니다.
작업 영수증 조회하기
curl "https://apimaster.ai/v1/videos/task_xxx/billing" \
-H "Authorization: Bearer YOUR_API_KEY"
GET /v1/videos/{task_id}/billing은 object: "video.billing_receipt", billing, customer_billing을 반환합니다. 작업 소유 계정의 API 키가 필요합니다. 원래 키로 GET /v1/video-submissions/by-key를 조회하면 data.customer_billing에 고객 청구 정보가 표시됩니다. final: true인 경우 net_amount가 최종 순청구액이며 USD 십진 문자열로 제공됩니다. 예전 작업도 환불이 확인되면 공급자 청구가 미확인 상태여도 고객 순청구액은 0으로 확정될 수 있습니다. 다른 계정의 작업이거나 청구 영수증과 환불 근거가 모두 없으면 작업 ID 조회에 HTTP 404가 반환됩니다. 다시 제출할 수 있는지는 기존 재시도 필드를 확인하세요.
동일한 billing 객체가 두 작업 조회 응답에 모두 포함됩니다:
GET /v1/videos/{task_id}: 최상위billing.GET /v1/video/generations/{task_id}:data.billing.
settlement_status는 pending, settled, refunded이며, 견적 응답은 estimate를 사용합니다. 작업 완료와 재무 정산은 별개입니다. 영수증이 settled 또는 refunded일 때만 금액을 최종 값으로 간주하십시오. 영수증을 반복 요청해도 생성, 정산, 환불이 실행되지 않습니다. 확정된 영수증은 환불 후에도 동일한 영수증 ID와 내용을 유지합니다.
전체 요청 및 응답 예시
두 예시 모두 Seedance 2.0, 480P, 요청 출력 4초,4.042초로 측정된 레퍼런스 1개, 채널 배수 1, 계정 배수 1.05를 사용합니다. 완료 시간과 금액은 실제 테스트에서 가져온 값이며, 견적은 동일한 입력에 맞춰 작성한 예시입니다. ID와 미디어 URL은 플레이스홀더입니다. 실제 요율은 API 응답에 따릅니다.
1. 견적 obtain하기
POST https://apimaster.ai/v1/videos/quote, 요청 JSON:
{
"model": "seedance-2.0",
"prompt": "A paper boat moves gently on a pond.",
"duration": 4,
"resolution": "480p",
"video_urls": [
"https://example.com/reference.mp4"
]
}
| 필드 | 타입 | 의미 |
|---|---|---|
model |
string | 모델 ID. 여기서는 seedance-2.0. |
prompt |
string | 생성 프롬프트. |
duration |
integer | 요청한 출력 초. 레퍼런스 비디오 길이가 아님. |
resolution |
string | 출력 해상도. 여기서는 480p. |
video_urls |
array |
레퍼런스 비디오 URL. 플레이스홀더를 접근 가능한 미디어로 교체하고, 서버가 각 파일을 측정함. |
견적 응답:
{
"object": "video.quote",
"quote_id": "quote_example",
"expires_at": 1790949324,
"binding": false,
"funds_reserved": false,
"billing": {
"schema_version": "1",
"settlement_status": "estimate",
"model": "seedance-2.0",
"resolution": "480P",
"tariff_variant": "480P-input",
"tariff_revision": "sd-v1-b79a35d3a29af9af",
"currency": "USD",
"unit": "second",
"base_unit_rate": "0.04319",
"channel_multiplier": 1,
"account_multiplier": 1.05,
"effective_unit_rate": "0.0453495",
"requested_output_seconds": 4,
"estimated_output_seconds": 4,
"estimated_billable_seconds": 9,
"input_videos": [
{
"index": 0,
"media_id": "media_example_hash",
"measured_seconds": 4.042,
"billable_seconds": 5,
"duration_source": "apimaster_probe"
}
],
"billable_input_video_seconds": 5,
"output": null,
"billable_seconds": null,
"rounding": {
"amount_formula": "round(total_billable_seconds * effective_unit_rate / account_unit_usd) * account_unit_usd",
"effective_unit_rate": "nearest_decimal_12_places_half_up",
"input_video": "ceil_each_file_then_sum",
"money": "nearest_account_unit_half_up",
"output_video": "nearest_integer_half_up"
},
"estimated_amount": "0.408146",
"reserved_amount": "0.000000",
"additional_debit_amount": "0.000000",
"final_debit_amount": null,
"refunded_amount": "0.000000",
"net_amount": null,
"initial_quota_units": 0,
"final_quota_units": null,
"account_unit_usd": "0.000002",
"media_charges": {
"audio": "0.000000",
"image": "0.000000",
"input_video_unrounded": "0.2267475",
"other_reference": "0.000000",
"output_video_unrounded": "0.181398"
},
"final_debit_may_exceed_estimate": true,
"created_at": 1790949024,
"settled_at": null
}
}
4.042초 입력은 5초로 올림됩니다. 추정 출력 4초와 합쳐 견적은 총 9초를 포함하며 비용은 0.408146 USD입니다. 견적은 funds를 차감하지 않으며, 최종 금액은 null로 유지됩니다.
2. 생성 제출 및 완료 조회
POST https://apimaster.ai/v1/videos/generations에 제출한 후, 초기 응답에 작업 ID가 포함됩니다:
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example"
}
]
}
그런 다음 동일한 계정의 API 키로 GET https://apimaster.ai/v1/videos/task_example을 조회합니다. 생성과 정산이 완료된 후:
{
"actual_time": 189,
"billing": {
"schema_version": "1",
"receipt_id": "bill_task_example",
"task_id": "task_example",
"settlement_status": "settled",
"model": "seedance-2.0",
"resolution": "480P",
"tariff_variant": "480P-input",
"tariff_revision": "sd-v1-b79a35d3a29af9af",
"currency": "USD",
"unit": "second",
"base_unit_rate": "0.04319",
"channel_multiplier": 1,
"account_multiplier": 1.05,
"effective_unit_rate": "0.0453495",
"requested_output_seconds": 4,
"estimated_output_seconds": 4,
"estimated_billable_seconds": 9,
"input_videos": [
{
"index": 0,
"media_id": "media_example_hash",
"measured_seconds": 4.042,
"billable_seconds": 5,
"duration_source": "apimaster_probe"
}
],
"billable_input_video_seconds": 5,
"output": {
"actual_seconds": 4,
"billable_seconds": 4,
"duration_source": "provider_reported"
},
"billable_seconds": 9,
"rounding": {
"amount_formula": "round(total_billable_seconds * effective_unit_rate / account_unit_usd) * account_unit_usd",
"effective_unit_rate": "nearest_decimal_12_places_half_up",
"input_video": "ceil_each_file_then_sum",
"money": "nearest_account_unit_half_up",
"output_video": "nearest_integer_half_up"
},
"estimated_amount": "0.408146",
"reserved_amount": "0.408146",
"additional_debit_amount": "0.000000",
"final_debit_amount": "0.408146",
"refunded_amount": "0.000000",
"net_amount": "0.408146",
"initial_quota_units": 204073,
"final_quota_units": 204073,
"account_unit_usd": "0.000002",
"media_charges": {
"audio": "0.000000",
"image": "0.000000",
"input_video_unrounded": "0.2267475",
"other_reference": "0.000000",
"output_video_unrounded": "0.181398"
},
"final_debit_may_exceed_estimate": true,
"created_at": 1790949024,
"settled_at": 1790949213
},
"completed_at": 1790949213,
"created_at": 1790949024,
"id": "task_example",
"metadata": {
"url": "https://apimaster.ai/v1/videos/task_example/content"
},
"model": "seedance-2.0",
"object": "video",
"progress": 100,
"status": "completed",
"task_id": "task_example",
"usage": {
"completion_tokens": 80770
}
}
이 경우 초기 차액은 최종 비용과 동일하며, 추가 차감이나 환불은 없습니다. billing.output.actual_seconds는 출력 길이이고, actual_time은 처리 시간입니다. usage.completion_tokens는 요금을 결정하지 않습니다. 선택적 필드는 채널에 따라 달라질 수 있습니다.
GET https://apimaster.ai/v1/videos/task_example/billing는 동일한 billing 객체와 함께 { "object": "video.billing_receipt", "billing": ... }를 반환합니다. 호환 조회 GET https://apimaster.ai/v1/video/generations/task_example에서는 data.billing 아래에 위치합니다.
최상위 응답 필드
| 필드 | 타입 | 의미 |
|---|---|---|
object |
string | 응답 유형: video.quote, video, 또는 video.billing_receipt. |
quote_id |
string | 정보용 견적 식별자. 가격 잠금이나 생성 승인이 아님. |
expires_at |
integer | Unix 초 기준 견적 권고 만료 시각. 일반적으로 생성 시각 + 300초. |
binding |
boolean | 현재 false. 견적은 최종 금액을 보장하지 않음. |
funds_reserved |
boolean | 현재 false. 견적 요청은 funds를 차감하거나 예약하지 않음. |
billing |
object | 아래에서 항목별로 설명하는 결제 세부 정보. |
code |
integer | 제출 응답 코드. 200은 제출됨을 의미하며 완료가 아님. |
data |
array | 제출된 작업 목록. 호환 조회는 대신 data에 객체를 사용함. |
data[].status |
string | 제출 상태. 이 예시에서는 submitted. |
data[].task_id |
string | 후속 조회에 사용되는 공개 작업 식별자. |
id |
string | 완료 조회에서의 공개 작업 ID. |
task_id |
string | 작업 식별자. 이 예시에서는 id와 동일. |
model |
string | 공개 생성 모델 이름. |
status |
string | 작업 상태. completed는 생성 종료를 의미. 최종 정산은 billing.settlement_status 확인. |
progress |
number | 진행률 백분율. 이 예시에서 완료 시 100. |
actual_time |
number | 작업 처리 초. 출력 비디오 길이가 아님. |
created_at |
integer | Unix 초 기준 작업 생성 타임스탬프. |
completed_at |
integer | Unix 초 기준 작업 완료 타임스탬프. |
metadata |
object | 생성 결과 메타데이터. |
metadata.url |
string | 비디오 콘텐츠 다운로드 URL. |
usage |
object | 제공자 사용량 정보. 채널에 따라 없을 수 있음. |
usage.completion_tokens |
integer | 제공자 토큰 수. 이 네 모델의 초당 과금에는 사용되지 않음. |
결제 스키마
모든 금액과 단위 요율은 십진 문자열입니다. 시간 길이는 초입니다. Nullable 필드는 확보될 때까지 JSON null입니다.
| 필드 | 타입 | 의미 |
|---|---|---|
schema_version |
string | 결제 스키마 버전. 이 예시에서는 "1". |
receipt_id |
string | 안정적인 영수증 식별자. 견적에는 없음. |
task_id |
string | 영수증과 연결된 공개 작업 ID. 견적에는 없음. |
settlement_status |
string | estimate, pending, settled, refunded |
model |
string | 적용된 공개 모델 ID. |
resolution |
string | 과금에 사용된 정규화된 해상도. |
tariff_variant |
string | 요금 등급. -input은 비디오 레퍼런스를 의미하며, 이 요율이 입력과 출력에 적용됨. |
tariff_revision |
string | 모델, 요금 등급, 설정된 기본 요율 및 과금 규칙 버전의 핑거프린트 |
currency |
string | 청구 통화. 현재 USD. |
unit |
string | 요율 단위. second는 초당을 의미. |
base_unit_rate |
decimal string | 이 모델 및 등급에 대해 설정된 초당 기본 가격. |
channel_multiplier |
number | 적용된 채널 가격 배수. |
account_multiplier |
number | 적용된 계정/그룹 배수. 이 예시에서는 1.05. |
effective_unit_rate |
decimal string | 적용된 초당 요율. 제출 시점에 고정되고 소수점 12자리로 반올림됨. |
requested_output_seconds |
integer | 요청한 출력 길이. 자동 길이는 -1 |
estimated_output_seconds |
integer | 추정 출력 초. 자동 길이는 30초로 추정됨. |
estimated_billable_seconds |
integer | 레퍼런스 비디오와 추정 출력을 포함한 초기 추정 총 과금 초. |
input_videos |
array | 요청 순서별 레퍼런스별 서버 측정값 |
input_videos[].index |
integer | 요청 내 레퍼런스 비디오 위치. 0부터 시작. |
input_videos[].media_id |
string | 계정 범위 미디어 해시 또는 보유 에셋 ID. 레퍼런스 비디오 URL은 echoed되지 않음. |
input_videos[].measured_seconds |
number or null | 반올림 전 서버 측정 길이. 오래된 캐시 에셋은 null일 수 있음 |
input_videos[].billable_seconds |
integer | 이 레퍼런스의 반올림된 과금 길이 |
input_videos[].duration_source |
string | apimaster_probe 또는 apimaster_asset_cache |
billable_input_video_seconds |
integer | 레퍼런스별 과금 초의 합 |
output |
object or null | 최종 출력 길이 정보. 성공적 정산 후 사용 가능 |
output.actual_seconds |
number or null | 제공자가 보고하거나 프로빙한 실제 출력 길이. 알 수 없으면 null |
output.billable_seconds |
integer | 정산에 실제로 사용된 출력 초 |
output.duration_source |
string | provider_reported, apimaster_probe, provider_billable_seconds, requested_duration_fallback, 또는 reservation_fallback |
billable_seconds |
integer or null | 최종 결합 과금 입력/출력 초 |
rounding |
object | 입력, 출력 및 금액 반올림 규칙과 금액 공식 |
estimated_amount |
decimal string | 초기 추정 비용. 최종 금액이나 최대 청구액 보증이 아님. |
reserved_amount |
decimal string | 제출 시점의 초기 계정 차액. 견적은 0. 은행 승인 홀드가 아님. |
additional_debit_amount |
decimal string | 최종 비용이 초기 차액을 초과할 때의 추가 차액. |
final_debit_amount |
decimal string or null | 조정 후 최종 순 작업 비용. 전액 환불 후 0 |
net_amount |
decimal string or null | 조정 후 최종 순 작업 비용. 전액 환불 후 0 |
refunded_amount |
decimal string | 초기 차액에서 반환된 금액. 전액 환불 시 초기 차액과 동일. |
initial_quota_units |
integer | 초기 차감된 정확한 계정 단위. 견적은 0. |
final_quota_units |
integer or null | 최종 순비용의 정확한 계정 단위. pending 중에는 null, 전액 환불 후 0. |
account_unit_usd |
decimal string | 계정 단위당 "0.000002" |
media_charges |
object | image, audio, other_reference는 현재 요금에서 0. input_video_unrounded와 output_video_unrounded는 최종 금액 반올림 전 비디오 구성 요소를 분리함 |
final_debit_may_exceed_estimate |
boolean | true. 견적은 하드 지출 상한이 아님 |
created_at |
integer | Unix 초 기준 결제 세부 정보 생성 타임스탬프. |
settled_at |
integer or null | Unix 초 기준 최종 정산 또는 환불 타임스탬프. 확정 전에는 null. |
| 필드 | 타입 | 의미 |
|---|---|---|
rounding.input_video |
string | ceil_each_file_then_sum: 각 입력 파일을 올림한 뒤 합산. |
rounding.output_video |
string | nearest_integer_half_up: 가장 가까운 출력 초로 반올림하고0.5초는 올림. |
rounding.effective_unit_rate |
string | nearest_decimal_12_places_half_up: 유효 요율을 소수점 12자리로 반올림. |
rounding.money |
string | nearest_account_unit_half_up: 결합 금액을 계정 단위로 반올림. |
rounding.amount_formula |
string | 최종 결합 금액 공식. 입력과 출력 금액은 각각 반올림되지 않음. |
media_charges.input_video_unrounded |
decimal string | 금액 반올림 전 입력 비디오 구성 요소. |
media_charges.output_video_unrounded |
decimal string | 금액 반올림 전 출력 비디오 구성 요소. |
media_charges.image |
decimal string | 별도 이미지 추가 요금. 현재 0. |
media_charges.audio |
decimal string | 별도 오디오 추가 요금. 현재 0. |
media_charges.other_reference |
decimal string | 기타 레퍼런스 추가 요금. 현재 0. |
최종 비용 재계산하기
레퍼런스 비디오가 있는 경우 비디오 입력 등급이 출력 초와 레퍼런스 비디오 초 모두에 적용됩니다. 현재 Seedance 요금에서 이미지와 오디오에는 별도 추가 요금이 없습니다. 토큰 수와 제공자 비용은 과금 입력 요소가 아닙니다.
- 각 입력 비디오의 측정 길이를 각각 독립적으로 올림한 뒤 합산합니다:
input_seconds = sum(ceil(each_video_duration)). - 출력 길이를 가장 가까운 정수 초로 반올림하고, 0.5초 초과는 올림합니다.
- 입력과 출력 과금 초를 더합니다.
effective_unit_rate를 곱하고,account_unit_usd로 나눈 뒤, 총액을 한 번만 가장 가까운 정수 계정 단위로 반올림하고 0.5 단위 초과는 올림합니다.
final_quota_units = round_half_up(billable_seconds × effective_unit_rate / 0.000002)
net_amount = final_quota_units × 0.000002
net_amount = reserved_amount + additional_debit_amount - refunded_amount
십진 연산을 사용하십시오. 입력과 출력 금액 구성 요소를 각각 반올림하지 마십시오. 예를 들어 기본 요율 0.07031, 채널 배수 1, 계정 배수 1.05인 480P Seedance 2.0 4초 작업에 레퍼런스 비디오가 없는 경우, 유효 요율은 0.0738255이고 순비용은 0.295302 USD(147651 계정 단위)입니다.
APIMaster는 input_seconds 또는 reference_seconds 같은 클라이언트 필드를 신뢰하지 않고 레퍼런스 비디오 길이를 측정합니다. 요청한 duration/seconds는 출력 길이를 제어합니다. 출력의 경우 정산은 제공자가 보고한 길이를 우선 사용하고 필요 시 출력을 프로빙합니다. 측정할 수 없는 경우 제공자 과금 초 또는 요청/예약 길이로 폴백할 수 있습니다. 영수증은 출처를 명시적으로 표시합니다. 폴백 값은 독립적으로 측정한 실제 길이로 표기되지 않습니다. 기존 캐시 에셋이나 상속된 이전 초안에는 파일별 측정 세부 정보가 완전하지 않을 수 있습니다.
비디오 응답의 actual_time은 출력 비디오 길이가 아닌 작업 처리 시간입니다. usage.completion_tokens는 존재할 경우 정보용입니다.
실패 및 환불
제공자 작업 실패와 설정된 24시간 미완료 작업 타임아웃은 자동 전액 환불을 발생시킵니다. 환불이 성공하면 해당 영수증은 계속 조회할 수 있고 순금액 0과 함께 refunded로 표시됩니다. 일시적인 폴링/네트워크 오류는 즉시 환불하거나 작업을 취소하지 않습니다. 처리가 재시도됩니다.
과금이 이루어지지 않았다고 확인된 제출 실패는 환불됩니다. 제출 결과가 모호한 경우 자동 대사를 위해 보류됩니다(첫 비동기 대사는 약 20분 후, 24시간 후에도 알 수 없는 결과는 대사 중 환불). 제출이 공개 작업을 생성하지 않은 경우 해당 시도에 연결된 작업 영수증은 없습니다. 견적은 예약이 아니므로 해제할 필요가 없습니다.
공개 Seedance 취소 엔드포인트는 없습니다. 연결 끊기나 폴링 중단은 작업을 취소하지 않습니다. 작업 상태 확인이 반복 폴링으로 동일한 완료 정산/환불이 다시 적용되는 것을 방지하며, 영수증 엔드포인트 자체는 읽기 전용입니다. 이는 모든 인프라 실패에 대한 일괄적 exactly-once 보증을 의미하지 않습니다. 대기 중인 재무 작업은 확정된 것으로 간주해서는 안 됩니다.
