curl --request POST 'https://api.voicecheap.ai/v1/actions/voices_design' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"requestId":"284a861a-4da8-4d67-ad48-8123e76c8e91","name":"Studio narrator","description":"A warm, clear English narrator with steady pacing and a natural conversational delivery.","language":"en"}'

const input = {
  requestId: '284a861a-4da8-4d67-ad48-8123e76c8e91',
  name: 'Studio narrator',
  description: 'A warm, clear English narrator with steady pacing and a natural conversational delivery.',
  language: 'en',
};
const response = await fetch('https://api.voicecheap.ai/v1/actions/voices_design', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.VOICECHEAP_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);

import os
import requests

response = requests.post(
    "https://api.voicecheap.ai/v1/actions/voices_design",
    headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
    json={"requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91", "name": "Studio narrator", "description": "A warm, clear English narrator with steady pacing and a natural conversational delivery.", "language": "en"},
    timeout=120,
)
body = response.json()
if not response.ok:
    raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)

{
  "data": {
    "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91",
    "status": "running",
    "pollAction": "action_request_get",
    "pollAfterSeconds": 5
  },
  "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91"
}

{
  "data": {
    "voicePreviews": [
      {
        "id": "44444444-4444-4444-8444-444444444444",
        "kind": "design",
        "name": "Studio narrator 1",
        "previewUrl": "https://files.example.com/designed-narrator-1.wav",
        "expiresAt": 1792238400000,
        "durationSeconds": 8
      },
      {
        "id": "55555555-5555-4555-8555-555555555555",
        "kind": "design",
        "name": "Studio narrator 2",
        "previewUrl": "https://files.example.com/designed-narrator-2.wav",
        "expiresAt": 1792238400000,
        "durationSeconds": 9
      }
    ],
    "creationUsage": {
      "cloneTrial": {
        "limit": 1,
        "used": 0,
        "remaining": 1
      },
      "design": {
        "limit": 5,
        "used": 1,
        "remaining": 4,
        "resetsAt": 1792195200000
      },
      "previewExpiresAfterHours": 24
    }
  },
  "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91"
}

{
  "data": {
    "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91",
    "operation": "voices_design",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "running",
    "pollAfterSeconds": 5
  },
  "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91"
}

{
  "data": {
    "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91",
    "operation": "voices_design",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "status": "completed",
    "resultStored": false,
    "message": "The action completed. Retrieve its output from the corresponding history or resource action."
  },
  "requestId": "284a861a-4da8-4d67-ad48-8123e76c8e91"
}