Operation

Generate Narration

Generate hosted narration audio with Cannon Studio's voice stack.

Start Here Operations Reference

Open Console OpenAPI Spec

Operation: narration.generate

Submit via POST /api/v1/requests

Credits: dynamic

Request fields

textvoice_idtonestabilitysimilarity_boostspeed

Example request

{
  "operation": "narration.generate",
  "input": {
    "text": "Sunny looks up from the table and realizes Austin has been bluffing the whole time.",
    "voice_id": "voice_123",
    "tone": "warm, grounded, cinematic",
    "stability": 0.7,
    "similarity_boost": 0.8,
    "speed": 1
  }
}

curl -X POST https://www.cannonstudio.app/api/v1/requests \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CANNON_API_KEY" \
  -H "x-idempotency-key: narration-generate-001" \
  -d @- <<'JSON'
{
  "operation": "narration.generate",
  "input": {
    "text": "Sunny looks up from the table and realizes Austin has been bluffing the whole time.",
    "voice_id": "voice_123",
    "tone": "warm, grounded, cinematic",
    "stability": 0.7,
    "similarity_boost": 0.8,
    "speed": 1
  }
}
JSON

Notes

Returns hosted narration audio immediately when the synthesis completes.
Uses the same narration voice stack and pricing logic as the Cannon Studio app.
Best for dialogue lines, voiceovers, and guided narration workflows.

Success output

{
  "asset_type": "audio",
  "status": "succeeded",
  "audio_url": "https://storage.googleapis.com/.../narration.mp3",
  "provider": "elevenlabs",
  "model": "narration"
}