> For the complete documentation index, see [llms.txt](https://docs.autocontentapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autocontentapi.com/quick-start/podcasts/single-custom-voice.md).

# Use One Custom Voice

Target a single narrator by calling the CustomVoices endpoint with only `voice1`. Voice fields must be numeric IDs from `/content/GetVoices`, not display names.

Fetch available voices first:

```bash
curl -X GET "https://api.autocontentapi.com/content/GetVoices" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

Example voice entry:

```json
{
  "id": 13,
  "name": "Donna (Narrative)",
  "gender": "f"
}
```

```bash
curl -X POST "https://api.autocontentapi.com/content/CreatePodcastCustomVoices" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "outputType": "audio",
    "voice1": 13,
    "resources": [
      {
        "type": "text",
        "content": "Highlights from this week''s roadmap, customer wins, and upcoming launches."
      }
    ],
    "text": "Record this as a solo host update with a warm, confident tone."
  }'
```

**Key fields**

* `voice1`: Required when using CustomVoices; pass the numeric `id` value from `/content/GetVoices` or the [Voices catalog](/voices.md).
* `voice2`: Omit this field to keep a single-speaker format.
* `endpoint`: Use `/content/CreatePodcastCustomVoices` whenever you provide explicit voices.

## Try it in code

* [C#](/code-samples/podcasts/csharp/single-custom-voice.md)
* [Node.js](/code-samples/podcasts/nodejs/single-custom-voice.md)
* [Java](/code-samples/podcasts/java/single-custom-voice.md)
* [PHP](/code-samples/podcasts/php/single-custom-voice.md)
* [Python](/code-samples/podcasts/python/single-custom-voice.md)