{
  "info": {
    "_postman_id": "c0e99364-e388-43a4-a52c-de3b06dc62ea",
    "name": "Audio Reports API Collection",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "AstrologyAPI Audio Reports collection. Includes 24 report APIs organized into Vedic Reports (12) and Western Reports (12) folders. No environment or collection variables are required.\n\nSetup:\n1. In each request's Headers tab, replace <YOUR_ACCESS_TOKEN> in the x-astrologyapi-key header with your AstrologyAPI access token. Authorization is set to No Auth.\n2. In each JSON request body, replace the example webhook-url with your public HTTPS receiver. Choose language, tone, voice-id, and duration-minutes directly in the body.\n3. Report requests return a queued request-id. The completed audio is sent to your webhook; its download-url is valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio"
  },
  "auth": {
    "type": "noauth"
  },
  "item": [
    {
      "name": "Vedic Reports",
      "description": "12 Vedic astrology audio reports. Set your access token in the x-astrologyapi-key request header.",
      "item": [
        {
          "name": "Personalized Kundali",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/personalized-kundali",
            "description": "A personal audio that explains who the person is, based on their birth chart. It talks about their personality, natural strengths, how they work and learn, their emotional needs and how they communicate, and ends with a few simple, practical suggestions.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/personalized-kundali",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"conversational\",\n  \"language\": \"hinglish\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-1\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "365-Day Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/365-days",
            "description": "An audio guide to the person's next twelve months. It explains what the year looks like overall and what to expect in career and work, health, money, and love and family, with the important periods of the year and simple practices to make the most of them.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/365-days",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"storyteller\",\n  \"language\": \"hi\",\n  \"duration-minutes\": 5,\n  \"voice-id\": \"vo-2\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Marriage Timing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/marriage-timing",
            "description": "An audio report on the person's marriage: when marriage is likely to happen, which periods are most favourable for it, what kind of life partner the chart suggests and how married life may unfold. It ends with simple practices and a short summary.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/marriage-timing",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"pandit-ji\",\n  \"language\": \"hi\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-8\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Compatibility",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/compatibility",
            "description": "A kundli-matching audio for two people. Send the details of both people (the partner's with the `partner-` fields) and the audio explains how well they match: the Guna Milan score, how their natures fit together, Manglik status, the best periods for marriage, things to be careful about and simple remedies.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/compatibility",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"partner-name\": \"Priya Verma\",\n  \"partner-day\": 2,\n  \"partner-month\": 11,\n  \"partner-year\": 1992,\n  \"partner-hour\": 18,\n  \"partner-minute\": 10,\n  \"partner-latitude\": 19.076,\n  \"partner-longitude\": 72.8777,\n  \"partner-timezone\": 5.5,\n  \"partner-gender\": \"female\",\n  \"tone\": \"conversational\",\n  \"language\": \"hinglish\",\n  \"duration-minutes\": 5,\n  \"voice-id\": \"vo-4\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Yearly Life Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/yearly-life",
            "description": "An audio guide to the year ahead, split into four three-month periods. It opens with the whole year in one picture, then explains for each period what is likely in the main areas of life and what the person can do, and closes with simple practices.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/yearly-life",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"news\",\n  \"language\": \"en\",\n  \"duration-minutes\": 7,\n  \"voice-id\": \"vo-3\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Child Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/child-report",
            "description": "An audio report about a child aged 0–16, spoken to the parents. It explains the child's nature, how they learn, their talents and interests, their emotional needs and the year ahead, with practical parenting guidance.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/child-report",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Aarav Sharma\",\n  \"day\": 22,\n  \"month\": 3,\n  \"year\": 2019,\n  \"hour\": 7,\n  \"minute\": 45,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"calm\",\n  \"language\": \"hinglish\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-9\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Nakshatra Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/nakshatra",
            "description": "An audio report on the person's birth star (nakshatra). It explains what the birth star says about their personality, career and money, relationships, wellbeing and spiritual side, the phase of life they are in now and the next twelve months.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/nakshatra",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"conversational\",\n  \"language\": \"ta\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-2\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Gemstone Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/gemstone",
            "description": "An audio report on which gemstones suit the person and why. It explains the main recommended stone, supporting stones, stones to avoid, how and when to wear them, substitutes and simple non-gem remedies. Gemstones are presented as support, never as a guarantee.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/gemstone",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"pandit-ji\",\n  \"language\": \"hi\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-8\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Married Life Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/married-life",
            "description": "An audio report on the person's married life: how they are as a partner, the kind of spouse the chart suggests, the emotional bond, how conflicts settle, family and in-laws, and the coming twelve months, with simple ways to build a happier marriage.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/married-life",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"conversational\",\n  \"language\": \"hinglish\",\n  \"duration-minutes\": 5,\n  \"voice-id\": \"vo-4\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Career Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/career",
            "description": "An audio report on the person's career: their natural strengths at work, the right work environment, suitable career paths, what may slow them down, and the key periods of the coming year with month-by-month guidance and what to do now.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/career",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"genz\",\n  \"language\": \"hinglish\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-7\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Past Life Karma",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/past-life",
            "description": "An audio report on the karmic story in the person's chart: the patterns and lessons carried from the past, relationships that feel familiar, the soul's purpose in this life and simple remedies. It is told as traditional, symbolic belief, not as historical fact.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/past-life",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"storyteller\",\n  \"language\": \"en\",\n  \"duration-minutes\": 5,\n  \"voice-id\": \"vo-5\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Love Life Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/vedic/love-life",
            "description": "An audio report on the person's love life: their relationship pattern, what they really need from a partner, who suits them, why delays or repeats happen, readiness for commitment and turning points in the next 6–12 months, with a simple action plan.\n\nSet webhook_url to your public HTTPS receiver. The request returns a queued request-id; the completed audio arrives by webhook. Download links are valid for 24 hours.\n\nDocumentation: https://www.astrologyapi.com/developers/v1/audio/love-life",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Rahul Sharma\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 28.6139,\n  \"longitude\": 77.209,\n  \"timezone\": 5.5,\n  \"gender\": \"male\",\n  \"tone\": \"roast\",\n  \"language\": \"hinglish\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-6\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Western Reports",
      "description": "12 Western astrology audio reports under https://audio.astrologyapi.com/v1/western. Set your access token in the x-astrologyapi-key request header. Each request documents its supported languages, tones, voices, and duration presets. Supply webhook-url to receive the finished audio.",
      "item": [
        {
          "name": "Complete Natal Chart Audio Reading",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/natal-reading",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Complete Natal Chart Audio Reading API creates a narrated Western astrology MP3 report from the supplied birth details. It explains the person’s core identity, emotional needs, communication style, relationships and natural strengths through their Sun, Moon, Rising sign and planetary placements. The reading brings together the main chart patterns and closes with practical suggestions.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"conversational\",\n  \"language\": \"de\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-2\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Birth Chart Blueprint Audio Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/birth-chart",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Birth Chart Blueprint Audio Report API creates a narrated Western astrology MP3 report from the supplied birth details. It explains how the birth chart is built, including the Sun, Moon and Rising signs, the chart ruler, dominant elements and modes, and the strongest planets. The reading connects these placements to the person’s character and the central pattern in their chart.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"coach\",\n  \"language\": \"ro\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-1\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Sun, Moon & Rising Audio Portrait",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/big-three",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Sun, Moon & Rising Audio Portrait API creates a narrated Western astrology MP3 report from the supplied birth details. It focuses on the Sun sign, Moon sign and Rising sign: the person’s core identity, emotional needs and the way others first experience them. The reading explains how these three placements work together, where they support one another and where their needs differ.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"bestie\",\n  \"language\": \"en\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-6\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Love & Relationship Compatibility Audio Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/love-compatibility",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Love & Relationship Compatibility Audio Report API creates a narrated Western astrology MP3 report from both people’s birth details. It compares both people’s birth charts to explore attraction, emotional connection, communication and commitment. The reading explains each person’s approach to love, the relationship’s strengths and friction points, and the compatibility score without treating it as a verdict.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `partner-name` (string, required): Partner: Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `partner-day` (int, required): Partner: Day of month, 1–31. Must form a real calendar date with month and year.\n- `partner-month` (int, required): Partner: Month, 1–12.\n- `partner-year` (int, required): Partner: Birth year, for example 1990.\n- `partner-hour` (int, required): Partner: Local birth hour, 0–23.\n- `partner-minute` (int, required): Partner: Local birth minute, 0–59.\n- `partner-latitude` (float, required): Partner: Birthplace latitude in decimal degrees, −90 to 90.\n- `partner-longitude` (float, required): Partner: Birthplace longitude in decimal degrees, −180 to 180.\n- `partner-timezone` (float, required): Partner: UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `partner-gender` (string, optional): Partner: male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"partner-name\": \"Luca Rossi\",\n  \"partner-day\": 3,\n  \"partner-month\": 11,\n  \"partner-year\": 1992,\n  \"partner-hour\": 14,\n  \"partner-minute\": 40,\n  \"partner-latitude\": 45.4642,\n  \"partner-longitude\": 9.19,\n  \"partner-timezone\": 1,\n  \"partner-gender\": \"male\",\n  \"tone\": \"dialogue\",\n  \"language\": \"fr\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-2\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Synastry & Relationship Dynamics Audio Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/synastry",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Synastry & Relationship Dynamics Audio Report API creates a narrated Western astrology MP3 report from both people’s birth details. It compares two birth charts to explain their main planetary contacts, shared strengths and areas of friction. The reading explores how the pair communicate, support and influence each other, and can be used for partners, friends, relatives or colleagues.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `partner-name` (string, required): Partner: Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `partner-day` (int, required): Partner: Day of month, 1–31. Must form a real calendar date with month and year.\n- `partner-month` (int, required): Partner: Month, 1–12.\n- `partner-year` (int, required): Partner: Birth year, for example 1990.\n- `partner-hour` (int, required): Partner: Local birth hour, 0–23.\n- `partner-minute` (int, required): Partner: Local birth minute, 0–59.\n- `partner-latitude` (float, required): Partner: Birthplace latitude in decimal degrees, −90 to 90.\n- `partner-longitude` (float, required): Partner: Birthplace longitude in decimal degrees, −180 to 180.\n- `partner-timezone` (float, required): Partner: UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `partner-gender` (string, optional): Partner: male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"partner-name\": \"Luca Rossi\",\n  \"partner-day\": 3,\n  \"partner-month\": 11,\n  \"partner-year\": 1992,\n  \"partner-hour\": 14,\n  \"partner-minute\": 40,\n  \"partner-latitude\": 45.4642,\n  \"partner-longitude\": 9.19,\n  \"partner-timezone\": 1,\n  \"partner-gender\": \"male\",\n  \"tone\": \"conversational\",\n  \"language\": \"es\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-1\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Attraction & Intimacy Audio Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/intimate-compatibility",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Attraction & Intimacy Audio Report API creates a narrated Western astrology MP3 report from both people’s birth details. It explores attraction, passion, affection and what helps each person feel emotionally close. Drawing on Venus, Mars, the Moon, Pluto and the fifth and eighth houses in both charts, the reading describes their chemistry in a warm, tasteful and non-explicit way.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `partner-name` (string, required): Partner: Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `partner-day` (int, required): Partner: Day of month, 1–31. Must form a real calendar date with month and year.\n- `partner-month` (int, required): Partner: Month, 1–12.\n- `partner-year` (int, required): Partner: Birth year, for example 1990.\n- `partner-hour` (int, required): Partner: Local birth hour, 0–23.\n- `partner-minute` (int, required): Partner: Local birth minute, 0–59.\n- `partner-latitude` (float, required): Partner: Birthplace latitude in decimal degrees, −90 to 90.\n- `partner-longitude` (float, required): Partner: Birthplace longitude in decimal degrees, −180 to 180.\n- `partner-timezone` (float, required): Partner: UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `partner-gender` (string, optional): Partner: male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"partner-name\": \"Luca Rossi\",\n  \"partner-day\": 3,\n  \"partner-month\": 11,\n  \"partner-year\": 1992,\n  \"partner-hour\": 14,\n  \"partner-minute\": 40,\n  \"partner-latitude\": 45.4642,\n  \"partner-longitude\": 9.19,\n  \"partner-timezone\": 1,\n  \"partner-gender\": \"male\",\n  \"tone\": \"calm\",\n  \"language\": \"it\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-4\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Karmic Bonds & Life Lessons Audio Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/karmic-links",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Karmic Bonds & Life Lessons Audio Report API creates a narrated Western astrology MP3 report from both people’s birth details. It explores the deeper patterns of a bond through the lunar nodes, Saturn, Pluto, Chiron and the way the two charts overlap. The reading explains why the connection may feel familiar and what the pair can learn together, as symbolic astrology rather than literal past lives or fate.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `partner-name` (string, required): Partner: Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `partner-day` (int, required): Partner: Day of month, 1–31. Must form a real calendar date with month and year.\n- `partner-month` (int, required): Partner: Month, 1–12.\n- `partner-year` (int, required): Partner: Birth year, for example 1990.\n- `partner-hour` (int, required): Partner: Local birth hour, 0–23.\n- `partner-minute` (int, required): Partner: Local birth minute, 0–59.\n- `partner-latitude` (float, required): Partner: Birthplace latitude in decimal degrees, −90 to 90.\n- `partner-longitude` (float, required): Partner: Birthplace longitude in decimal degrees, −180 to 180.\n- `partner-timezone` (float, required): Partner: UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `partner-gender` (string, optional): Partner: male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"partner-name\": \"Luca Rossi\",\n  \"partner-day\": 3,\n  \"partner-month\": 11,\n  \"partner-year\": 1992,\n  \"partner-hour\": 14,\n  \"partner-minute\": 40,\n  \"partner-latitude\": 45.4642,\n  \"partner-longitude\": 9.19,\n  \"partner-timezone\": 1,\n  \"partner-gender\": \"male\",\n  \"tone\": \"mystic\",\n  \"language\": \"pt\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-3\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "12-Month Astrology Audio Forecast",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/year-ahead",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The 12-Month Astrology Audio Forecast API creates a narrated Western astrology MP3 report from the supplied birth details. It explains the next twelve months through the annual profection, solar-return chart and major transits. The reading brings together the year’s central theme, important dates, month-by-month highlights and retrograde periods, with practical ways to work with the year ahead.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"briefing\",\n  \"language\": \"el\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-9\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Personal Transit Audio Forecast",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/transit-report",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Personal Transit Audio Forecast API creates a narrated Western astrology MP3 report from the supplied birth details. It explains the next three months of planetary movement over the person’s birth chart, including when each important transit begins and peaks. The reading connects these periods to the life areas they affect and describes what each transit asks of the person.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"dialogue\",\n  \"language\": \"zh\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-7\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Birthday Year Audio Forecast",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/solar-return",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Birthday Year Audio Forecast API creates a narrated Western astrology MP3 report from the supplied birth details. It interprets the chart for the person’s birthday-to-birthday year, covering the return Ascendant, Sun, Moon, angular planets and key aspects. The reading explains how the return chart connects with the birth chart and brings the main themes of the year into focus.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"storyteller\",\n  \"language\": \"hu\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-8\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Five-Year Life Journey Audio Forecast",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/life-forecast",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Five-Year Life Journey Audio Forecast API creates a narrated Western astrology MP3 report from the supplied birth details. It explores the next five years as a sequence of life phases, using slow-moving planetary transits, profections, Saturn and Jupiter returns, and progressions. The reading explains the major changes and dated periods that shape this longer view of the person’s life.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"tone\": \"storyteller\",\n  \"language\": \"ru\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-5\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "Zodiac Sign Compatibility Audio Report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "x-astrologyapi-key",
                "value": "<YOUR_ACCESS_TOKEN>",
                "type": "text"
              }
            ],
            "url": "https://audio.astrologyapi.com/v1/western/star-sign-compatibility",
            "description": "The audio download-url is valid for 24 hours from the time it is issued. Download or save the MP3 before the link expires.The Zodiac Sign Compatibility Audio Report API creates a narrated Western astrology MP3 report from both people’s birth details. It compares two Sun signs through their elements, temperaments and compatibility score. The reading explores where the pair naturally connect, communicate and comfort each other, alongside honest friction points and simple ways to handle them in everyday life.The API accepts the request immediately and returns a request-id. When the audio is ready, its download-url is delivered by a POST request to the supplied public HTTPS webhook-url. The callback also reports a failed job when generation cannot be completed.Customize tone, language, voice-id and duration-minutes using the parameter allowed values. Supported durations are 1, 3, 5, 7 and 9 minutes; 3 minutes is the default. The default language follows a supported Accept-Language header, otherwise en.Authenticate with the x-astrologyapi-key header, or HTTP Basic authentication using userId:apiKey. Send the request body as application/json.\n\n### Request parameters\n\n- `name` (string, required): Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `day` (int, required): Day of month, 1–31. Must form a real calendar date with month and year.\n- `month` (int, required): Month, 1–12.\n- `year` (int, required): Birth year, for example 1990.\n- `hour` (int, required): Local birth hour, 0–23.\n- `minute` (int, required): Local birth minute, 0–59.\n- `latitude` (float, required): Birthplace latitude in decimal degrees, −90 to 90.\n- `longitude` (float, required): Birthplace longitude in decimal degrees, −180 to 180.\n- `timezone` (float, required): UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `gender` (string, optional): male, female, or other. Allowed values: male, female, other.\n- `partner-name` (string, required): Partner: Person's name, 1–80 characters. The narration addresses the listener by first name.\n- `partner-day` (int, required): Partner: Day of month, 1–31. Must form a real calendar date with month and year.\n- `partner-month` (int, required): Partner: Month, 1–12.\n- `partner-year` (int, required): Partner: Birth year, for example 1990.\n- `partner-hour` (int, required): Partner: Local birth hour, 0–23.\n- `partner-minute` (int, required): Partner: Local birth minute, 0–59.\n- `partner-latitude` (float, required): Partner: Birthplace latitude in decimal degrees, −90 to 90.\n- `partner-longitude` (float, required): Partner: Birthplace longitude in decimal degrees, −180 to 180.\n- `partner-timezone` (float, required): Partner: UTC offset in hours, −12 to 14. Fractional values are allowed, such as 5.5.\n- `partner-gender` (string, optional): Partner: male, female, or other. Allowed values: male, female, other.\n- `tone` (string, optional): Narration style. Defaults to conversational. See Tones. Allowed values: conversational, dialogue, storyteller, roast, coach, calm, briefing, bestie, mystic.\n- `language` (string, optional): Language options are shown as code - language name. Send only the code or a supported language name. Defaults to a supported Accept-Language header, otherwise en. Chinese uses Simplified characters and Mandarin speech. Allowed values: en - English, de - German, fr - French, es - Spanish, pt - Portuguese, it - Italian, hu - Hungarian, tr - Turkish, ro - Romanian, el - Greek, ru - Russian, zh - Chinese (Mandarin, Simplified characters).\n- `duration-minutes` (int, optional): Length of the audio: 1, 3, 5, 7, or 9. Defaults to 3. Allowed values: 1, 3, 5, 7, 9.\n- `voice-id` (string, optional): Voice choices are shown as voice_name(voice_id) - description. Send the voice ID or name only. Defaults to the voice for the tone. For dialogue, the selected voice is the astrologer and the host uses a voice of the other gender. Allowed values: oliver(vo-1) - Warm and steady male., emma(vo-2) - Warm, clear and reassuring female., noah(vo-3) - Gentle and unhurried male., grace(vo-4) - Soft and calm female., marcus(vo-5) - Deep and grounded male., leo(vo-6) - Young and lively male., mia(vo-7) - Young and bright female., arthur(vo-8) - Mature and measured male., eleanor(vo-9) - Mature and caring female..\n- `webhook-url` (string, optional): Public HTTPS URL that receives the completion or failure callback. Optional in the schema, but supply it to be told when the audio is ready.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Emma Müller\",\n  \"day\": 15,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 10,\n  \"minute\": 30,\n  \"latitude\": 52.52,\n  \"longitude\": 13.405,\n  \"timezone\": 1,\n  \"gender\": \"female\",\n  \"partner-name\": \"Luca Rossi\",\n  \"partner-day\": 3,\n  \"partner-month\": 11,\n  \"partner-year\": 1992,\n  \"partner-hour\": 14,\n  \"partner-minute\": 40,\n  \"partner-latitude\": 45.4642,\n  \"partner-longitude\": 9.19,\n  \"partner-timezone\": 1,\n  \"partner-gender\": \"male\",\n  \"tone\": \"roast\",\n  \"language\": \"tr\",\n  \"duration-minutes\": 3,\n  \"voice-id\": \"vo-7\",\n  \"webhook-url\": \"https://example.com/webhooks/audio\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        }
      ]
    }
  ]
}
