Skip to content
GET
https://api.voice213.com/api/v1/models
Try it
curl https://api.voice213.com/api/v1/models \
  -H "Authorization: Bearer $VOICE213_API_KEY"
{
  "success": true,
  "currency": "DZD",
  "defaultModel": "voice213-lite",
  "minBillableChars": 100,
  "models": [
    {
      "id": "voice213-lite",
      "name": "Voice213 Lite",
      "quality": "standard",
      "description": "Fast & reliable",
      "descriptionAr": "سريع وموثوق",
      "pricePer1MChars": 9000,
      "pricePer1kChars": 9,
      "default": true,
      "priceChanges": []
    },
    {
      "id": "voice213-lite-2",
      "name": "Voice213 Lite 2",
      "quality": "lite2",
      "description": "New generation, fast",
      "descriptionAr": "الجيل الجديد، سريع",
      "pricePer1MChars": 8000,
      "pricePer1kChars": 8,
      "default": false,
      "priceChanges": [{ "from": "2027-01-01", "pricePer1MChars": 15000 }]
    },
    {
      "id": "voice213-pro",
      "name": "Voice213 Pro",
      "quality": "pro",
      "description": "Higher quality",
      "descriptionAr": "جودة أعلى",
      "pricePer1MChars": 20000,
      "pricePer1kChars": 20,
      "default": false,
      "priceChanges": []
    },
    {
      "id": "voice213-pro-1.5",
      "name": "Voice213 Pro 1.5",
      "quality": "pro1.5",
      "description": "Most natural",
      "descriptionAr": "الأكثر طبيعية",
      "pricePer1MChars": 39000,
      "pricePer1kChars": 39,
      "default": false,
      "priceChanges": []
    },
    {
      "id": "voice213-pro-2",
      "name": "Voice213 Pro 2",
      "quality": "pro2",
      "description": "Newest & most expressive",
      "descriptionAr": "الأحدث والأكثر تعبيراً",
      "pricePer1MChars": 12000,
      "pricePer1kChars": 12,
      "default": false,
      "priceChanges": [{ "from": "2027-01-01", "pricePer1MChars": 24000 }]
    }
  ]
}

Returns the voice models you can pass as model to Text to Speech, with the price each one charges today, in dinars, and any price change already scheduled. It's free, and it doesn't count toward your rate limits.

Read it when your app starts rather than hard-coding prices: when a price changes, this list has it first. A scheduled change shows up in priceChanges before it happens, and the new price becomes pricePer1MChars on its date, at midnight UTC.

A model can be paused for the API for a while. It stays in the list, with "available": false, and Text to Speech refuses it with 503 MODEL_DISABLED until it's back. Pick another model meanwhile.

Authorizations

Authorizationstringrequired

Your API key as a Bearer token: Bearer sk_live_.... See Authentication.

Response

application/json
successbooleanrequired

true.

currencystringrequired

DZD: every price is in Algerian dinars.

defaultModelstringrequired

The model a request uses when it names none: voice213-lite.

minBillableCharsnumberrequired

The fewest characters a request is billed for: 100.

modelsobject[]required

The five models, always in the same order.

Show properties
idstringrequired

The ID to send as model, such as voice213-pro-2.

namestringrequired

The model's name, such as Voice213 Pro 2.

qualitystringrequired

The model's older name, which quality still accepts, such as pro2.

descriptionstringrequired

A short description in English, such as Newest & most expressive.

descriptionArstringrequired

The same description in Arabic, such as «الأحدث والأكثر تعبيراً».

pricePer1MCharsnumberrequired

The price today, in dinars per million characters.

pricePer1kCharsnumberrequired

The same price per 1,000 characters.

defaultbooleanrequired

true for the model a request uses when it names none.

priceChangesobject[]required

Price changes still to come, oldest first, or an empty list. Each has from, the date it takes effect (YYYY-MM-DD, at midnight UTC), and pricePer1MChars, the new price.

availableboolean

Only there while the model is paused for the API, and then false: a voice-over with it gets 503 MODEL_DISABLED. A model without this field can be used.

​Work out a price yourself

A voice-over costs its billable characters times the model's price:

cost = max(characters, minBillableChars) × pricePer1MChars ÷ 1,000,000

rounded to four decimals, in dinars. Characters are counted without tone directions of up to 100 characters (a longer one counts like the rest of the text), with runs of spaces counted once. To skip the arithmetic, ask Estimate Cost: it counts the characters of your text for you.

Was this page helpful?