xai/tts-v1

Texto para Fala

xAI TTS v1 API by xAI

xai/tts-v1

Tts-v1

xAI TTS v1 is a high-fidelity text-to-speech model that converts text into natural, expressive speech with sub-second latency, supporting 20 languages and 80+ voices with fine-grained delivery control.

Entrada

Carregando configuração de parâmetros...

Saída

Inativo

Your generated audio will appear here

Enter text and click Generate to synthesize speech.

Parâmetros

Exemplo de código
import requests
import time

# Step 1: Start audio generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "xai/tts-v1",
    "prompt": "A beautiful sunset over the ocean with gentle waves",
    "width": 512,
    "height": 512,
    "duration": 3,
    "fps": 24,
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated audio:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

audio_url = check_status()

Instalar

Instale o pacote necessário para a sua linguagem de programação.

pip install requests

Autenticação

Todas as solicitações de API requerem autenticação por meio de uma chave de API. Você pode obter sua chave de API no painel do Atlas Cloud.

export ATLASCLOUD_API_KEY="your-api-key-here"

Cabeçalhos HTTP

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

Mantenha sua chave de API segura

Nunca exponha sua chave de API em código do lado do cliente ou repositórios públicos. Use variáveis de ambiente ou um proxy de backend.

Enviar uma solicitação

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Enviar uma solicitação

Envie uma solicitação de geração assíncrona. A API retorna um ID de predição que você pode usar para verificar o status e obter o resultado.

POST/api/v1/model/generateAudio

Corpo da solicitação

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "xai/tts-v1",
    "input": {
        "text": "Hello, welcome to AtlasCloud text-to-speech."
    }
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")

Resposta

{
  "id": "pred_abc123",
  "status": "processing",
  "model": "model-name",
  "created_at": "2025-01-01T00:00:00Z"
}

Verificar status

Consulte o endpoint de predição para verificar o status atual da sua solicitação.

GET/api/v1/model/prediction/{prediction_id}

Exemplo de polling

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

Valores de status

processingA solicitação ainda está sendo processada.

completedA geração está completa. As saídas estão disponíveis.

succeededA geração foi bem-sucedida. As saídas estão disponíveis.

failedA geração falhou. Verifique o campo de erro.

Resposta concluída

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp3"
    ],
    "metrics": {
      "predict_time": 8.3
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Schema de entrada

Os seguintes parâmetros são aceitos no corpo da solicitação.

Total: 0Obrigatório: 0Opcional: 0

Nenhum parâmetro disponível.

Exemplo de corpo da solicitação

{
  "model": "xai/tts-v1"
}

Schema de saída

A API retorna uma resposta de predição com as URL de saída geradas.

idstringrequired

Unique identifier for the prediction.

statusstringrequired

Current status of the prediction.

processingcompletedsucceededfailed

modelstringrequired

The model used for generation.

outputsarray[string]

Array of output URLs. Available when status is "completed".

errorstring

Error message if status is "failed".

metricsobject

Performance metrics.

predict_timenumber

Time taken for image generation in seconds.

created_atstringrequired

ISO 8601 timestamp when the prediction was created.

Format: date-time

completed_atstring

ISO 8601 timestamp when the prediction was completed.

Format: date-time

Exemplo de resposta

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.png"
  ],
  "metrics": {
    "predict_time": 8.3
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

O Atlas Cloud Skills integra mais de 300 modelos de IA diretamente no seu assistente de codificação com IA. Um comando para instalar e depois use linguagem natural para gerar imagens, vídeos e conversar com LLM.

Clientes compatíveis

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ clientes compatíveis

Instalar

npx skills add AtlasCloudAI/atlas-cloud-skills

Configurar chave de API

Obtenha sua chave de API no painel do Atlas Cloud e defina-a como variável de ambiente.

export ATLASCLOUD_API_KEY="your-api-key-here"

Funcionalidades

Após a instalação, você pode usar linguagem natural no seu assistente de IA para acessar todos os modelos do Atlas Cloud.

Geração de imagensGere imagens com modelos como Nano Banana 2, Z-Image e mais.

Criação de vídeosCrie vídeos a partir de texto ou imagens com Kling, Vidu, Veo, etc.

Chat com LLMConverse com Qwen, DeepSeek e outros modelos de linguagem de grande escala.

Upload de mídiaEnvie arquivos locais para fluxos de trabalho de edição de imagens e imagem para vídeo.

Saiba mais

github.com/AtlasCloudAI/atlas-cloud-skills

MCP Server

O Atlas Cloud MCP Server conecta seu IDE com mais de 300 modelos de IA através do Model Context Protocol. Funciona com qualquer cliente compatível com MCP.

Clientes compatíveis

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ clientes compatíveis

Instalar

npx -y atlascloud-mcp

Configuração

Adicione a seguinte configuração ao arquivo de configuração de MCP do seu IDE.

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Ferramentas disponíveis

atlas_generate_imageGere imagens a partir de prompts de texto.

atlas_generate_videoCrie vídeos a partir de texto ou imagens.

atlas_chatConverse com modelos de linguagem de grande escala.

atlas_list_modelsExplore mais de 300 modelos de IA disponíveis.

atlas_quick_generateCriação de conteúdo em uma etapa com seleção automática de modelo.

atlas_upload_mediaEnvie arquivos locais para fluxos de trabalho de API.

Saiba mais

github.com/AtlasCloudAI/mcp-server

API Schema

Schema não disponível

Sem exemplos disponíveis

Faça login para ver o histórico de solicitações

Você precisa fazer login para acessar o histórico de solicitações do modelo.

Fazer Login

xAI TTS v1 — Text to Speech

Developer: xAI
Model ID: xai/tts-v1
Release Date: April 2026

Overview

xAI TTS v1 is a high-fidelity text-to-speech model developed by xAI, the company behind Grok. It converts text into natural, expressive speech with sub-second latency, supporting 20 languages and a rich voice library of 80+ voices. The model features fine-grained delivery control through inline speech tags, multiple audio output formats for both streaming and telephony use cases, and a voice cloning capability that can produce a production-ready custom voice from roughly a minute of reference audio.

xAI TTS v1 is designed for real-world production workloads — customer service bots, content narration, accessibility tools, and real-time voice agents — offering competitive per-character pricing with enterprise-grade compliance.

Key Capabilities

Expressive delivery control — 14 instant speech tags and 13 wrapping style tags for pauses, laughter, whispers, pitch shifts, speed changes, and more.
80+ voices across 20 languages — Five universal multilingual voices plus language-optimized voices for Chinese, Russian, Italian, French, Spanish, Hindi, Japanese, Korean, Portuguese, German, Dutch, Polish, Turkish, Arabic, Vietnamese, Thai, Danish, Swedish, Finnish, and English.
Flexible audio output — MP3, WAV, PCM, μ-law, and A-law codecs with sample rates from 8 kHz (telephony) to 48 kHz (studio).
Voice cloning — Record up to 120 seconds of reference audio; a custom voice_id is ready in under 2 minutes at no additional cost.
Streaming and batch modes — Both a standard REST endpoint and a WebSocket streaming endpoint for real-time audio delivery.
Automatic language detection — Set language: "auto" to let the model identify the input language.
Privacy-first — Audio is never stored or used for model training.

Use Cases

Customer service / IVR — Low-latency telephony output (μ-law/A-law at 8 kHz) for automated voice response systems.
Content narration — Podcast episodes, audiobooks, and video voiceovers with expressive, human-like delivery.
Accessibility — Real-time screen readers and reading assistants for visually impaired users.
Real-time voice agents — Paired with xAI's Speech-to-Text and Voice Agent APIs for end-to-end conversational AI.
Multilingual applications — Localized content delivery across 20 languages from a single API.
Custom brand voices — Clone a spokesperson's voice to maintain consistent audio identity at scale.

Voices

Multilingual Voices

These five voices support all 20 available languages.

Voice ID	Name	Gender	Character
`eve`	Eve	Female	Energetic, upbeat — default voice
`ara`	Ara	Female	Warm and conversational
`leo`	Leo	Male	Authoritative, instructional
`rex`	Rex	Male	Professional, business tone
`sal`	Sal	Male	Versatile, neutral

Language-Optimized Voices (selected)

Language-specific voices are optimized for their native language and automatically lock the language field when selected.

Language	Voices
English	Grace (F), Claire (F), James (M), Daniel (M)
Chinese (Mandarin)	Jian (M), Hao (F), Xia (F)
Russian	Pavel (M), Andrei (M), Dmitri (M), Irina (F)
French	Remi (M), Hugo (M), Camille (F)
Spanish	Manuel (M), Javier (M), Diego (M), Andres (M)
Italian	Enzo (M), Matteo (M), Alessandro (M), Luca (F)
German	Moritz (M), Niklas (M), Clara (F), Lena (F)
Japanese	Ren (M), Sakura (F)
Korean	Jun-seo (M), Min-jun (M), Seo-yeon (F), Ji-yeon (F)
Portuguese	Mateus (M), Rafael (M), Beatriz (F)
Hindi	Karan (M), Ananya (F)
Arabic	Khalid (M), Tariq (M), Layla (F)
Turkish	Emre (M), Kaan (M), Aylin (F)
Dutch	Thijs (M), Ruben (M), Femke (F), Noor (F)
Polish	Mateusz (M), Jakub (M), Katarzyna (F), Aleksandra (F)
Vietnamese	Duc (M), Minh (M), Mai (F)
Swedish	Axel (M), Erik (M), Saga (F)
Finnish	Valtteri (M), Eero (M), Helmi (F), Elina (F)
Thai	Krit (M), Aroon (M)
Danish	Lars (M), Kasper (M), Ida (F)

The complete voice library, including custom cloned voices, is accessible via the voice_id parameter.

Supported Languages

Code	Language
`auto`	Auto Detect
`en`	English
`zh`	Chinese (Mandarin)
`ar-EG`	Arabic (Egypt)
`ar-SA`	Arabic (Saudi Arabia)
`ar-AE`	Arabic (UAE)
`bn`	Bengali
`fr`	French
`de`	German
`hi`	Hindi
`id`	Indonesian
`it`	Italian
`ja`	Japanese
`ko`	Korean
`pt-BR`	Portuguese (Brazil)
`pt-PT`	Portuguese (Portugal)
`ru`	Russian
`es-MX`	Spanish (Mexico)
`es-ES`	Spanish (Spain)
`tr`	Turkish
`vi`	Vietnamese

Input Parameters

Parameter	Type	Default	Description
`model`	string	`xai/tts-v1`	Model identifier. Required.
`text`	string	—	Text to synthesize. Maximum 15,000 characters. Supports inline speech tags. Required.
`language`	string	`auto`	BCP-47 language code or `"auto"` for automatic detection. Required.
`voice_id`	string	`eve`	Voice identifier. Multilingual voices support all languages; language-optimized voices lock to their native language.
`codec`	string	`mp3`	Output audio codec: `mp3`, `wav`, `pcm`, `mulaw`, `alaw`.
`sample_rate`	integer	`24000`	Sample rate in Hz. Options: `8000`, `16000`, `22050`, `24000`, `44100`, `48000`.
`bit_rate`	integer	`128000`	Bit rate in bps. MP3 only. Options: `32000`, `64000`, `96000`, `128000`, `192000`.
`speed`	number	`1.0`	Playback speed multiplier. Range: `0.7` (slower) to `1.5` (faster).
`text_normalization`	boolean	`false`	When `true`, converts written-form text (numbers, abbreviations, symbols) to spoken form before synthesis.
`optimize_streaming_latency`	integer	`0`	Streaming latency trade-off: `0` = best quality, `1` = lower first-chunk latency, `2` = lowest first-chunk latency.

Audio Format Recommendations

Use Case	Codec	Sample Rate	Bit Rate
Standard playback (default)	`mp3`	24,000 Hz	128,000 bps
Studio / high-fidelity	`mp3` or `wav`	44,100 or 48,000 Hz	192,000 bps
Telephony / IVR	`mulaw` or `alaw`	8,000 Hz	—
Streaming (web)	`mp3`	22,050 Hz	64,000 bps

Inline Speech Tags

Speech tags let you control delivery at a granular level within the text field.

Instant Tags

Insert at any point in the text to trigger an immediate vocal event.

Tag	Effect
`[pause]`	Brief pause
`[long-pause]`	Extended pause
`[hum-tune]`	Soft humming sound
`[laugh]`	Full laugh
`[chuckle]`	Short chuckle
`[giggle]`	Light giggle
`[cry]`	Crying sound
`[tsk]`	Disapproving tsk
`[tongue-click]`	Tongue click
`[lip-smack]`	Lip-smack sound
`[breath]`	Audible breath
`[inhale]`	Inhalation
`[exhale]`	Exhalation
`[sigh]`	Sigh

Wrapping Style Tags

Wrap text to apply a delivery style to the enclosed span.

Tag	Effect
`<soft>…</soft>`	Softer, quieter delivery
`<whisper>…</whisper>`	Whispered speech
`<loud>…</loud>`	Louder, more projected delivery
`<build-intensity>…</build-intensity>`	Gradually increasing intensity
`<decrease-intensity>…</decrease-intensity>`	Gradually decreasing intensity
`<higher-pitch>…</higher-pitch>`	Raised pitch
`<lower-pitch>…</lower-pitch>`	Lowered pitch
`<slow>…</slow>`	Slower delivery
`<fast>…</fast>`	Faster delivery
`<sing-song>…</sing-song>`	Melodic, sing-song pattern
`<singing>…</singing>`	Full singing mode
`<laugh-speak>…</laugh-speak>`	Spoken with laughter mixed in
`<emphasis>…</emphasis>`	Stressed emphasis on words

Example:

"Welcome back! [pause] <whisper>Just between us</whisper>, the sale ends tonight. [laugh] Don't miss it!"

Rate Limits

Limit	Value
Requests per minute (RPM)	3,000
Requests per second (RPS)	50
Concurrent sessions per team	100
Maximum characters per request	15,000

Pricing

Pricing is based on the number of characters in the input text field.

SKU

SKU	Description	Unit Price
`sku_per_1k_chars`	Per 1,000 characters synthesized	$0.015

Formula

cost = countChars(text) / 1000 × sku_per_1k_chars

Where countChars(text) counts the total number of characters in the input text (including spaces and punctuation, excluding inline speech tags consumed by the model).

The effective rate is $15.00 per 1,000,000 characters.

Examples

Input Length	Characters	Cost
Short sentence	100 chars	$0.0015
One paragraph	500 chars	$0.0075
Article excerpt	2,000 chars	$0.0300
Maximum single request	15,000 chars	$0.2250

Custom cloned voices are billed at the same per-character rate as built-in voices — there is no additional charge for using a voice_id from the Voice Library.

Enterprise Features

SOC 2 Type II certified
HIPAA eligibility with Business Associate Agreement (BAA)
GDPR compliance with data residency options
SAML SSO and role-based access control (RBAC)
Multi-region infrastructure with custom SLAs available
No data retention — audio is never stored or used for model training

References

Explorar Modelos Semelhantes

Uma API para toda a IA de mídia.

Explorar Todos os Modelos

xAI TTS v1 API by xAI

Entrada

Saída

Parâmetros

Exemplo de código

Instalar

Autenticação

Cabeçalhos HTTP

Enviar uma solicitação

Enviar uma solicitação

Corpo da solicitação

Resposta

Verificar status

Exemplo de polling

Valores de status

Resposta concluída

Schema de entrada

Exemplo de corpo da solicitação

Schema de saída

Exemplo de resposta

Atlas Cloud Skills

Clientes compatíveis

Instalar

Configurar chave de API

Funcionalidades

MCP Server

Clientes compatíveis

Instalar

Configuração

Ferramentas disponíveis

API Schema

Faça login para ver o histórico de solicitações

xAI TTS v1 — Text to Speech

Overview

Key Capabilities

Use Cases

Voices

Multilingual Voices

Language-Optimized Voices (selected)

Supported Languages

Input Parameters

Audio Format Recommendations

Inline Speech Tags

Instant Tags

Wrapping Style Tags

Rate Limits

Pricing

SKU

Formula

Examples

Enterprise Features

References

Explorar Modelos Semelhantes

Uma API para toda a IA de mídia.

Join our Discord community

Entrada

Saída

Parâmetros

Exemplo de código

Instalar

Autenticação

Cabeçalhos HTTP

Enviar uma solicitação

Enviar uma solicitação

Corpo da solicitação

Resposta

Verificar status

Exemplo de polling

Valores de status

Resposta concluída

Schema de entrada

Exemplo de corpo da solicitação

Schema de saída

Exemplo de resposta

Atlas Cloud Skills

Clientes compatíveis

Instalar

Configurar chave de API

Funcionalidades

MCP Server