Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Generate voiceovers, music, or sound effects from text prompts and optional voice references.
curl -X POST "https://api.mosaic.so/agent/create" \
-H "Authorization: Bearer mk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Launch voiceover",
"visibility": "private"
}'
curl -X POST "https://api.mosaic.so/agent/AGENT_ID/update" \
-H "Authorization: Bearer mk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"operations": [
{
"op": "create_node",
"node_type_id": "14687f30-5fd0-468f-8239-2784d83df95b",
"params_used": {
"mode": "voiceover",
"model": "eleven_v3",
"script": "Introducing the fastest way to turn ideas into publish-ready videos.",
"use_upstream_voice_reference": false
}
}
]
}'
curl -X POST "https://api.mosaic.so/agent/AGENT_ID/run" \
-H "Authorization: Bearer mk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"callback_url": "https://your-webhook.com/mosaic"
}'
Node Params & API Details
14687f30-5fd0-468f-8239-2784d83df95b| Param | Type | Required | Default | Notes |
|---|---|---|---|---|
mode | "voiceover" | "music" | "sfx" | No | "voiceover" | Audio generation mode. |
model | "eleven_v3" | "music" | No | "eleven_v3" | Audio model for the selected mode. |
script | string | Conditional | "" | Required for voiceover mode. |
voice_id | string | No | curated default | Voice ID when no upstream voice reference is used. |
use_upstream_voice_reference | boolean | No | true | Use selected upstream audio/video as a voice reference. |
selected_context | {audio:string[],videos:string[],voice_reference?:string} | No | empty lists | Attached references. |
music_prompt | string | Conditional | "" | Required for music mode. |
music_length_ms | number | No | 30000 | Music duration, 5-300 seconds. |
sfx_prompt | string | Conditional | "" | Required for sfx mode. |
sfx_length_seconds | number | No | auto | Sound effect duration in seconds, 0.5-30. Omit for automatic length. |
{
"mode": "voiceover",
"model": "eleven_v3",
"script": "This is the voiceover text.",
"use_upstream_voice_reference": false
}
{
"mode": "music",
"model": "music",
"music_prompt": "Warm upbeat electronic background music for a product launch",
"music_length_ms": 45000
}
{
"mode": "sfx",
"sfx_prompt": "Short whoosh followed by a camera shutter click",
"sfx_length_seconds": 3
}
Was this page helpful?