Voices

Create a voice

Builds a reusable voice profile from 2–20 writing samples by the same person. Samples are used for style only; facts in them are never copied into rewrites.

POST

Billing. Not billed. 3 voices on Basic API, 15 on Pro API, unlimited on Ultra API. Credits & pricing

curl -X POST https://api.intactvoice.com/v1/voices \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Founder voice",
  "samples": [
    "…",
    "…"
  ],
  "platforms": [
    "x",
    "blog"
  ]
}'

Response

{
  "id": "voice_8f2k1x",
  "object": "voice",
  "name": "Founder voice",
  "samples": 2,
  "words": 1197,
  "traits": {
    "sentence_length_sd": 9.4,
    "uses_em_dash": false,
    "numbered_steps": true,
    "endings": "status_update"
  },
  "baseline": {
    "ai_likelihood_mean": 0.19
  }
}

200 OK · 400 Bad Request

Body

application/json

namestringrequired

Label shown in the dashboard.

samplesstring[]required

2–20 texts, at least 1,200 words in total.

platformsstring[]

Where these samples were published; tunes formatting habits.

Response

200 · application/json

idstring

voice_…

traitsobject

Measured habits: sentence-length spread, punctuation, openings, endings.

baselineobject

How the Detect API scores this writer's own samples.

Body

Response

Errors