Passer à la navigation

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.

Authentification

x-api-keystring
Authentification par clé API via en-tête

Requête

This endpoint expects an object.
modelstringRequis

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

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

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

Valeurs autorisées:
reasoningEnabledbooleanOptionnel
Include reasoning pricing when supported by the model.

Réponse

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.

durationCheckobjectOptionnel

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.

breakdownobjectOptionnel

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.

Erreurs

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