Skip to content
96Astro API

Blog

Audio astrology reports: turn a Kundli into a spoken MP3 in 26 languages

· 96Astro API team · 5 min read · Reports, Guides

Headphones, a celestial sphere and a waveform illustrate narrated astrology reports.

How an audio report API turns career, marriage and Kundli reports into narrated MP3s in 26 languages, with six voices, four tones, costs and product ideas.

In brief

  • An audio astrology report turns a written reading (career, marriage, wealth, a full Kundli) into a spoken MP3.
  • With the 96Astro API one request does it all: the report is calculated, a script is written from the report's own facts, and a voice reads it out.
  • Choose from 26 languages, six voices and four tones, from 1 to 30 minutes, and address the listener by name.
  • It costs the report's credits plus 800 credits a minute, and nothing if the job fails. Sandbox keys get a free one-minute version.

Many people would rather listen than read, especially in regional languages and among older users who find a 40-page PDF daunting. Audio also travels well: an MP3 can be shared through messaging apps when the recipient consents. This guide explains how an audio astrology report API works, how to build listen-along reports into an app, and how to price them.

When audio reports can be useful

  • Regional languages. A Hindi, Marathi, Tamil or Bengali narration reaches users who would never read a long English report.
  • Personal. "Asha, your tenth house is strong this year" lands differently when it is spoken.
  • Shareable. An MP3 is easy to send to family, which is how astrology spreads in many households.
  • Premium feel. A spoken report feels like a consultation, so it supports a higher price than a PDF.

How the audio report API works

POST /v1/jobs/audio runs as a background job, exactly like a PDF:

  1. The report is calculated from the birth details, using any report capability.
  2. A script is written by a language model, using only what the report says. The prompt restricts it to those facts; validate the script because model errors remain possible.
  3. A voice reads it in the language, voice and tone you chose.
  4. You download the MP3 from a time-limited link, or receive a webhook when it is ready.

The narration is AI-written and AI-spoken. Say so in your app.

A first audio report request

curl https://api.96astroapi.com/v1/jobs/audio \
  -H "Authorization: Bearer $ASTRO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f1c2d1e-0b9a-4a77-9c2e-7a4f1b2c3d4e" \
  -d '{
    "capability": "report-career",
    "input": { "datetime": "1990-10-18T14:30:00", "timezone": "Asia/Kolkata", "latitude": 28.6139, "longitude": 77.209 },
    "language": "hi",
    "minutes": 5,
    "tone": "warm",
    "voice": "meera",
    "listener_name": "Asha"
  }'
FieldRequiredMeaning
capabilityYesAny report capability: report-career, report-marriage, report-wealth, classical-kundli-report, matching-report and more
inputYesThat report's own request body
languageNoAny of the 26 languages, default English
minutesNoAbout how long it should be, 1 to 30, default 5
toneNowarm (default), calm, formal or friendly
voiceNomeera (default), arjun, tara, dev, isha or kabir
listener_nameNoUsed to address the listener

Send an Idempotency-Key and reuse it with the identical body when retrying within the documented retention window. A new key or an expired record may create a new billable job.

Getting the finished MP3

Poll GET /v1/jobs/{id} or set up a webhook for job.succeeded and job.failed. A finished job has an audio object with seconds (the real length), voice, tone, language and minutes_requested, plus a download_url. Download the file promptly and store it yourself if users should keep it. See jobs and webhooks.

Choosing a voice and tone

VoiceCharacter
meeraFemale, the default: clear and warm
arjun, dev, kabirMale voices
tara, ishaOther female voices

Hear a sample of each on the Audio Report API page. For tone, warm suits most readings, calm suits spiritual and health topics, formal suits a classical Kundli, and friendly suits younger audiences and compatibility.

Which reports work best as audio

ReportWhy it worksSuggested length
CareerSpecific, practical, popular5 minutes
MarriageHigh emotional value, shared with family5 to 8 minutes
WealthClear themes and timing5 minutes
Kundli matchingCouples and parents listen together5 to 10 minutes
Complete KundliPremium, long-form15 to 30 minutes
Yearly forecast (Varshaphal)A once-a-year ritual8 to 12 minutes

Audio report costs

The price is the report's own credits plus 800 credits for each minute you ask for. A five-minute career report is 10 + 4,000 = 4,010 credits. Using the published ₹2,499 / 60,000-credit monthly allowance as an illustration, full utilisation implies about ₹0.04165 per credit and ₹167.02 for that job, excluding taxes and other operating costs. At lower utilisation the effective cost is higher. Check current pricing before quoting customers. If the job fails, nothing is charged.

Sandbox keys get a one-minute narration for free, within the sandbox's daily job limit, so you can build and test the whole flow first.

Pricing audio reports

  • As an upgrade. "Add the audio version for ₹149" at the PDF checkout.
  • As a premium product. A ten-minute marriage report for ₹499.
  • In a subscription. One audio report a month for premium members.
  • Gift reports. A spoken report as a birthday or wedding gift, addressed to the recipient by name.

Product ideas

  • Listen-along reports. Show the PDF and play the audio on the same screen.
  • Daily audio notes. A one-minute daily horoscope in the user's language, generated once per sign and day and shared by everyone with that sign.
  • WhatsApp delivery. Send the MP3 link after purchase.
  • Regional-language funnels. Lead with audio in Hindi, Marathi or Tamil, when listening better fits your audience.
  • Consultant hand-offs. An astrologer sends a client the audio summary after a consultation.

Good practice

  • Tell users it is an AI-narrated reading.
  • Let them choose the language and voice before they pay.
  • Keep the listener's name optional, and never put sensitive details in it.
  • Store the MP3 only as long as you promise, and let users delete it.

Frequently asked questions

What is an audio astrology report?

A spoken MP3 of an astrology report, such as a career or marriage reading, narrated in the language and voice you choose.

Which languages are supported for audio reports?

All 26 languages of the API, including Hindi, Marathi, Bengali, Gujarati, Tamil, Telugu, Kannada, Malayalam, Punjabi, Odia, Assamese and Urdu, and major European and Asian languages.

How long can an audio report be?

From 1 to 30 minutes. The narration aims for the length you ask for, and the finished job reports the real length in seconds.

Is the narration accurate to the chart?

The script is grounded in the calculated report, but grounding does not guarantee a faithful narration. Check placements, dates, names and pronunciation against the source report. It is AI-written and AI-spoken, which you should tell your users.

How much does an audio report cost?

The report's credits plus 800 credits per minute. A five-minute career report is 4,010 credits. Failed jobs are not charged, and sandbox keys get a free one-minute version.

Can I create audio reports without code?

Yes. In the dashboard, open PDF and audio jobs, fill in the birth details, choose the language, voice, tone and length, and create the report.

Get started

Listen to the voices on the Audio Report API page, read the audio reports guide, and create your first one-minute sample with a free sandbox key.

Get the next guide by email

One email a month with new guides and API changes. No account needed.

About once a month: new guides, API features and astrology-developer news. We email a confirmation link first; unsubscribe with one click from any newsletter. See our privacy policy.

Send us feedback

What is it about?