Generate audio
generate_audioSubmit a speech generation request through Rainbrand’s public API. Use a supported audio model returned by list_models and follow its published input schema from get_model. Use relevant brand context to write the text to speak. Returns the generation ID and its current status. Inspect the result with get_generation.
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": {
"brand_session_id": "<brand_session_id>",
"model": "<model>",
"input": "<input>"
},
"name": "generate_audio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Arguments for the selected model, using the field names and reference formats published by get_model. | |
| model | Yes | Model to run. Choose an ID from list_models whose output type matches the generation tool being called. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| idempotency_key | No | Retry key for recovering the original generation after an uncertain response. Reuse it with identical arguments. Without a key, repeating the request starts another generation. | |
| brand_session_id | Yes | Brand session ID from list_brands for the brand this generation belongs to. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Generation ID. Pass it as id to get_generation. | |
| status | Yes | Current generation status. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |