Quote a generation
quote_generationPrice a request exactly, and compare it to the balance, without creating anything. target picks the room: image, clip, voice (the generate_voiceover arguments), music (the generate_music brief) or guided (a guided recipe). Takes the same arguments as the matching generate tool.
To price a whole plan — a voice-over and the clips it drives, say — pass requests instead: up to 20 of the same objects, each with its own target. The answer is one line per request, the total and whether the balance covers it; a line that cannot run says why and the rest still price.
An avatar clip whose reference audio already exists is priced at that audio's length. Use only the account's existing entitlements: when a plan does not fit, explain it without offering purchases.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "quote_generation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | ||
| model | No | ||
| speed | No | ||
| voice | No | ||
| inputs | No | ||
| lyrics | No | ||
| prompt | No | ||
| target | No | ||
| choices | No | ||
| emotion | No | ||
| presets | No | ||
| runs_on | No | Who pays: "credits", or one of the user's own keys by vendor (get_credits lists them). Leave out to follow their payer order; set it only when the user chose. | |
| setting | No | ||
| subject | No | ||
| model_id | No | ||
| requests | No | ||
| subjects | No | Names or ids of the account's Subjects (list_subjects). The server supplies each one's face and description — seated against the model's capacity — so do not also attach pictures of them. | |
| recipe_id | No | ||
| last_frame | No | ||
| references | No | The pictures this generation can see — uploads and generations alike, in the shape list_media returns. This is the only field that carries image data into the model. The selected model’s reference capacity applies (list_models). | |
| resolution | No | ||
| first_frame | No | ||
| recreate_of | No | ||
| aspect_ratio | No | ||
| refined_from | No | Lineage only — this records that the new image is the next version of that one, and carries NO pixels. Put the same generation in `references` or the model sees no picture. Prefer edit_image, which sets both from one id; reach for this only to hand-assemble a refine edit_image cannot express. | |
| style_prompt | No | ||
| language_code | No | ||
| generate_audio | No | ||
| creative_prompt | No | ||
| idempotency_key | No | Optional. Pass the same value to retry one operation without spending twice; omit it for a new operation. Different arguments under a reused key are refused. | |
| is_instrumental | No | ||
| duration_seconds | No | ||
| reference_audios | No | ||
| reference_images | No | ||
| reference_videos | No | The video this clip is driven by — a source performance to copy, or the take a mouth is re-synced in. Uploads and clips you generated alike, in the shape list_media returns. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | Yes | ||
| policy | Yes | ||
| credits | Yes | ||
| message | Yes | ||
| affordable | Yes | ||
| aspect_ratio | Yes | ||
| available_credits | Yes |