estimate_credits
Free dry run: validates parameters and returns the exact credit cost without charging. Also reports why a generation would be rejected (subscription required, model offline, too many concurrent jobs, invalid params, daily cap).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"model": "<model>"
},
"name": "estimate_credits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | For song and speech: simple = describe it; custom = write the lyrics / exact script yourself. Not needed for type sound_effect (mode "sound_effect" without type is also accepted). | |
| type | No | song = a song with music; sound_effect = a short sound effect / loop; speech = spoken voice-over / narration with optional background music (not singing). See list_models[].types. | song |
| model | Yes | Model id from list_models (e.g. "suno", "acestep"). | |
| params | No | Parameters for the chosen type + mode: list_models[].params[mode] for songs, list_models[].params.sound_effect for sound effects, list_models[].speech.params[mode] for speech. Unknown keys are rejected. | |
| version | No | Version id from list_models; omit for the model's default version. |