Migrating to verified voice-cloning consent

Creating a cloned voice now proves the speaker agreed, in place of the consent object you used to send. If your integration still posts a consent form field to POST /v1/voices, this page moves you to the verified consent-challenge flow. The change was announced in the changelog.

What is changing

Consent used to be an assertion — a consent object carrying the speaker’s fullName and email. It is now verified: the speaker reads a phrase we issue, and you send that recording as the consent record.

A pinned default never moves on its own, so migrating means re-pinning Speechify-Version: 2026-09-13. Workspaces created on or after that date are on the verified flow already.

Are you affected?

You are affected if POST /v1/voices sends a consent form field. If your create already sends consent_challenge_id and consent_recording, you are on the new flow — nothing to do.

The new flow

Cloning is now two calls: a consent leg that proves agreement, then the create you already make.

1. Create a consent challenge

When your speaker is ready to record, create a challenge with their full_name. It returns a phrase and an id.

from speechify import Speechify
client = Speechify(
    token="YOUR_TOKEN_HERE",
)
client.voices.consent_challenges.create(
    idempotency_key="a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    full_name="Jane Doe",
)

Show the phrase to the speaker exactly as it comes back and record them reading it aloud. A challenge is single use, bound to your workspace, and short-lived — create it at record time, not at the start of your flow. If it expires, create another and record again.

2. Create the voice with the recording

Send the recording as consent_recording alongside consent_challenge_id. Speechify transcribes it, checks it against the phrase it issued, and keeps it as the voice’s consent record.

from speechify import Speechify
client = Speechify(
    token="YOUR_TOKEN_HERE",
)
client.voices.create(
    idempotency_key="a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    sample="example_sample",
    avatar="example_avatar",
    consent_recording="example_consent_recording",
)

What moves, what’s gone

• full_name moves from the old consent object onto the challenge call.
• email is dropped — nothing replaces it.
• consent_challenge_id and consent_recording become required on POST /v1/voices.
• The endpoint, your existing voice ids, and every synthesis call are unchanged.

Handle the new refusals

Three new errors share HTTP 422, so branch on the code, not the status:

One more, on HTTP 400: consent_verification_required means the create still sent the old consent field and no challenge. The fix is this guide.

If you use an SDK

Each SDK release sends its own build date as the default version. An SDK published on or after 2026-09-13 takes consent_challenge_id and consent_recording as required arguments and has no consent argument, so the call stops compiling until it is migrated rather than failing at runtime. Pinning an older version does not bring the old flow back: it was switched off for every version.

Migration checklist

See also

• Voice cloning now verifies consent — the announcement
• The unverified flow was switched off on 2026-09-23 — the date
• Consent — the challenge lifecycle, recording rules, and every refusal
• Voice Cloning API — the full create reference
• API Versioning — reading and pinning Speechify-Version