AURA VOICE

BUILD WITH AURA

Voice, in your
application.

Voice-only developer credentials are available to signed-in accounts. Commercial billing remains disabled. Streaming availability is engine- and language-specific; review the connected capabilities in Studio.

Authenticate and generate

Create an expiring, revocable credential in Studio Settings, grant only the scopes your application needs, and keep the secret on your server. Every generation requires an account-scoped idempotency key; retrying identical input with that key returns the original job instead of generating twice.

POST /v1/text-to-speech
Authorization: Bearer av_prod_…
Idempotency-Key: your-unique-request-id
Content-Type: application/json

{"text": "Hello, I'm Aura.",
 "voice_id": "aura-narrator", "language": "en"}

Use GET /v1/developer/jobs/{job_id} for status and /audio for the completed private artifact. Credentials support explicit generate, read, download, and usage scopes with server-enforced request and daily generation limits.

Request and response

text is required (1–5,000 characters). voice_id defaults to aura-narrator; language defaults to en. A successful request returns HTTP 202 with a private job_id. Poll the job until its state is COMPLETED, FAILED, or CANCELLED, then request audio only for a completed job.

// Server-side JavaScript: keep this ID for retries of identical input.
const requestId = crypto.randomUUID();
const response = await fetch("https://voice.globalieta.com/v1/text-to-speech", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.AURA_VOICE_KEY}`,
    "Idempotency-Key": requestId,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ text: "A calm, clear introduction.", language: "en" })
});
const { job_id } = await response.json();

Errors and limits

400 / 422
Correct the request body or unsupported setting before retrying.
401 / 403
Use an active credential with the required scope and allowed network policy.
409
The idempotency key was reused with different input; create a new key.
429
Wait for the Retry-After interval before retrying.
502 / 503
Keep the same idempotency key while checking the job; do not create duplicate work.

Credential owners configure per-minute request and daily generation limits in Studio Settings. Keys expire after the selected period and can be revoked immediately.

Keep private audio private.

Never embed credentials in browser code. Secrets are shown once and stored only as hashes. Private audio requires authentication; permission to create a clone does not make it publicly shareable.