Estimate Task Credits

Estimate the generation cost in the workspace associated with your API key. Use the same model, resolution, duration, output count and options as in the Topview task panel. The estimate reads current pricing and benefits. You can repeat it without creating a task, debiting or freezing credits, or consuming free uses.

Read result.estimatedCredits for the total before benefits and result.estimatedPayableCredits for the expected charge after benefits. For example, a 5-second 720p Topview T1 Recast can return 6.5 credits before benefits and 0 payable when one free use covers the request. Prices and benefits can change before submission.

Find a model. Call GET /v1/agent/topview/generation/config?type=image&taskType=storyboard&forEstimate=true with the same credentials. Use the appropriate type and taskType for your task. Select a model using its backendModelCode or submitModel. Generation endpoints can have a different list of supported models.

Postpaid tasks. Audio design returns a per-second rate. Automatic duration and an unknown source duration for Recast or video upscaling can also produce a postpaid estimate. A null total means the cost is unknown. An eligible benefit may still reduce the expected payable amount to zero.

MCP. Call topview_estimate_task_credits with the same request body inside req. For example, {"req":{"taskType":"audio_design","model":"Seed Audio 1.0"}}.

Invalid task settings, unavailable models and ineligible Unlimited requests return a business error. Check the response code before reading the result.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required

Task to estimate.

string

Use the backendModelCode or submitModel from generation config for the selected task. For Recast, specify the same model as the intended submission.

Model-supported resolution, e.g. 720, "720p" or "2K". For standalone upscaling, use the target resolution.

string

Output aspect ratio supported by the model, e.g. 16:9.

string

Quality tier selected for this model.

string
enum

Video sound setting.

Allowed:
number

Seconds. For Recast, motion control and video upscaling, use the source video duration. For multi-shot generation, sum the shot durations. Pass -1 only for models that support automatic duration.

number

Alias for duration. Supply only one of the two fields.

integer
1 to 4
Defaults to 1

Number of outputs for supported image or video batch tasks. Use 1 for storyboard, motion control and music.

boolean
Defaults to false

A video is included among the references.

boolean
Defaults to false

Use draft pricing on supported models.

boolean
Defaults to false

Include automatic upscaling for each video output.

string

Target resolution for automatic video upscaling. Defaults to 2K.

integer
1 to 240
Defaults to 30

Frame rate for standalone video upscaling.

string
enum
Defaults to drama_beat

Pricing source for high-quality storyboard extension.

Allowed:
boolean
Defaults to false

Apply Unlimited pricing when the workspace, model and resolution qualify. The base task is covered. Automatic video upscaling may still cost credits.

string
enum

Image output format. GIF and SVG may carry a surcharge.

Allowed:
integer
0 to 128

Number of reference images supplied.

integer
1 to 1000000

Billable character count for instant voice cloning and script-driven avatars. For avatars with a known audio duration, send duration.

string

Task-specific mode, e.g. avatar4, avatar4Fast or avatar2 for photo avatars.

boolean
Defaults to false

Request off-peak pricing for a supported photo avatar mode.

Responses

401

Missing, invalid or expired API credentials.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json