Zur Navigation springen

estimate cost

Estimate a generation from its model and billable duration in seconds. Supply a finite positive duration and, optionally, a finite positive fps (defaults to 25 for credit-billed organizations and 30 otherwise). Set workflow to translate-and-dub to include dubbing; the response then carries a breakdown. durationCheck says whether your account and the model allow the quoted duration. No media is fetched and no generation is created. POST /v2/generate/estimate-cost is an alias of this endpoint. Invalid request fields return 400. If the billing calculation rejects the duration or frame rate, it returns 422 cost_estimate_unavailable without price fields.

Authentifizierung

x-api-keystring
API-Key-Authentifizierung via Header

Anfrage

This endpoint expects an object.
modelstringErforderlich

Model to estimate, for example lipsync-2 or sync-3.

durationdoubleErforderlich
Finite, positive billable duration in seconds.
fpsdoubleOptional
Finite, positive source video frame rate. For standard plans, defaults to 25 for credit billing and 30 for usage billing when omitted.
workflowenumOptional

Omit for lip-sync only. translate-and-dub includes dubbing and lip-sync, estimated using the source duration. Actual output duration may differ.

Erlaubte Werte:
reasoningEnabledbooleanOptional
Include reasoning pricing when supported by the model.

Antwort

A single estimate; estimatedCredits is null for dollar-billed organizations.

estimatedFrameCountdouble
The estimated frame count for the generation.
estimatedGenerationCostdouble
The estimated cost of the generation in USD.
estimatedCreditsdouble or null

Estimated credits for credit-billed organizations; null for dollar-billed organizations.

durationCheckobjectOptional

Whether your account and the selected model can generate the quoted duration right now. A price is not permission to generate; admission rechecks every limit.

breakdownobjectOptional

Present for translate-and-dub. Top-level amounts are the combined Sync estimate. External provider charges are unpriced (null) and excluded; included dubbing has no additional Sync charge. Estimates do not reserve credits or guarantee admission.

Fehler

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
500
Internal Server Error