API de Texto para Fala

Converta texto em fala natural com a API TTS. Mais de 300 vozes de IA, clonagem ilimitada de vozes e geração de fala realista
300+ Vozes de IA
Clonagem de Voz
REST API
TTS Editor Interface
Com a confiança de mais de 500.000 usuários

Recursos poderosos da API TTS

Tudo o que você precisa para integrar texto para fala profissional em seus aplicativos
TTS Neural
300+ Vozes de IAAcesse vozes neurais premium em mais de 33 idiomas, incluindo inglês, português, espanhol, francês, alemão, chinês, japonês e muito mais.
Ilimitado
Clonagem de VozCrie vozes personalizadas a partir de amostras de áudio com clonagem de voz ilimitada. Perfeito para conteúdo personalizado e vozes de marca.
Global
33+ IdiomasSuporte para mais de 33 idiomas, incluindo inglês, português, espanhol, francês, alemão, chinês, japonês e muitos outros.

Fluxo de trabalho da API TTS

Converta texto em fala com apenas algumas chamadas de API simples
01

Criar Projeto TTS

Crie um novo projeto de texto para fala com seu conteúdo de texto e preferências de voz.
API Request
curl -X POST "https://dubsmart.ai/api/v1/projects/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My TTS Project",
    "segments": [
      {
        "text": "Hello, this is a test message",
        "voice": "anna_en_v2",
        "language": "en"
      }
    ]
  }'
02

Monitorar Processamento

Acompanhe o progresso do seu projeto TTS enquanto ele processa seu texto em fala natural.
API Request
curl -X GET "https://dubsmart.ai/api/v1/projects/tts/{projectId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response:
{
  "id": "project_id",
  "status": "processing",
  "progress": 75,
  "segments": [
    {
      "id": "segment_id",
      "status": "completed",
      "audioUrl": "https://..."
    }
  ]
}
03

Baixar Áudio

Baixe arquivos de áudio de alta qualidade quando o processamento estiver concluído. Obtenha formato MP3 com qualidade de 22kHz.
API Request
curl -X GET "https://dubsmart.ai/api/v1/projects/tts/{projectId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

# When status is "completed":
{
  "id": "project_id",
  "status": "completed",
  "audioUrl": "https://storage.dubsmart.ai/audio.mp3",
  "segments": [
    {
      "id": "segment_id",
      "audioUrl": "https://storage.dubsmart.ai/segment.mp3"
    }
  ]
}

Endpoints da API TTS

Referência completa da API para funcionalidade de texto para fala
POST
/projects/tts

Criar Projeto TTS

Crie um novo projeto de texto para fala com segmentos de texto e configurações de voz
Request
JSON
{
  "title": "My TTS Project",
  "segments": [
    {
      "text": "Hello world! This is a test message.",
      "voice": "anna_en_v2",
      "language": "en",
      "speed": 1.0,
      "pitch": 1.0
    }
  ]
}
Response
JSON
{
  "id": "64f8a2b1c3d4e5f6a7b8c9d0",
  "title": "My TTS Project",
  "status": "pending",
  "progress": 0,
  "createdAt": "2023-09-06T10:30:00Z",
  "segments": [
    {
      "id": "segment_1",
      "text": "Hello world! This is a test message.",
      "status": "pending"
    }
  ]
}
GET
/projects/tts

Obter Projetos TTS

Recupere uma lista de seus projetos TTS com paginação e opções de filtragem
Request
JSON
Query Parameters:
- limit: number (default: 20, max: 100)
- cursor: string (for pagination)
- status: "pending" | "processing" | "completed" | "failed"
Response
JSON
{
  "items": [
    {
      "id": "64f8a2b1c3d4e5f6a7b8c9d0",
      "title": "My TTS Project",
      "status": "completed",
      "progress": 100,
      "createdAt": "2023-09-06T10:30:00Z",
      "audioUrl": "https://storage.dubsmart.ai/audio.mp3"
    }
  ],
  "nextCursor": "next_cursor_value"
}
GET
/projects/tts/{projectId}

Obter Projeto TTS por ID

Recupere informações detalhadas sobre um projeto TTS específico
Request
JSON
Path Parameters:
- projectId: string (required)
Response
JSON
{
  "id": "64f8a2b1c3d4e5f6a7b8c9d0",
  "title": "My TTS Project",
  "status": "completed",
  "progress": 100,
  "createdAt": "2023-09-06T10:30:00Z",
  "audioUrl": "https://storage.dubsmart.ai/audio.mp3",
  "segments": [
    {
      "id": "segment_1",
      "text": "Hello world! This is a test message.",
      "status": "completed",
      "audioUrl": "https://storage.dubsmart.ai/segment_1.mp3"
    }
  ]
}

Exemplos de código da API TTS

Exemplos de código prontos para uso em várias linguagens de programação
JavaScript Example
// JavaScript/Node.js Example
const axios = require('axios');

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://dubsmart.ai/api/v1';

async function createTTSProject() {
  try {
    // Create TTS project
    const projectResponse = await axios.post(`${BASE_URL}/projects/tts`, {
      title: 'My TTS Project',
      segments: [
        {
          text: 'Hello! This is a sample text for text-to-speech conversion.',
          voice: 'anna_en_v2',
          language: 'en',
          speed: 1.0,
          pitch: 1.0
        },
        {
          text: 'This is the second segment with a different voice.',
          voice: 'john_en_v2',
          language: 'en',
          speed: 1.1,
          pitch: 0.9
        }
      ]
    }, {
      headers: { 'Authorization': `Bearer ${API_KEY}` }
    });

    console.log('Project created:', projectResponse.data);
    
    // Monitor project status
    const projectId = projectResponse.data.id;
    await monitorProjectStatus(projectId);
    
    return projectResponse.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

// Monitor project status
async function monitorProjectStatus(projectId) {
  let status = 'pending';
  
  while (status !== 'completed' && status !== 'failed') {
    await new Promise(resolve => setTimeout(resolve, 5000)); // Wait 5 seconds
    
    const response = await axios.get(`${BASE_URL}/projects/tts/${projectId}`, {
      headers: { 'Authorization': `Bearer ${API_KEY}` }
    });
    
    status = response.data.status;
    console.log(`Project status: ${status}, Progress: ${response.data.progress}%`);
    
    if (status === 'completed') {
      console.log('Audio URL:', response.data.audioUrl);
      console.log('Segments:', response.data.segments);
    }
  }
}

// Usage
createTTSProject();

FAQ

O que é a API TTS e como funciona?Nossa API TTS é um serviço RESTful que converte texto em fala natural usando tecnologia avançada de IA. Basta enviar uma solicitação POST com seu conteúdo de texto e preferências de voz e receber arquivos de áudio de alta qualidade em retorno.
Quantas vozes e idiomas estão disponíveis?Nossa API TTS oferece acesso a mais de 300 vozes de IA premium em mais de 33 idiomas e dialetos. Isso inclui idiomas populares como inglês, espanhol, francês, alemão, chinês, japonês e muitos outros.
Posso usar clonagem de voz com a API?Sim! Nossa API suporta clonagem de voz personalizada ilimitada. Você pode criar vozes personalizadas fornecendo amostras de áudio e usá-las em seus projetos TTS.
Quais formatos e qualidades de áudio a API suporta?A API TTS gera áudio de alta qualidade no formato MP3.
Quanto tempo leva para processar solicitações TTS?O tempo de processamento depende do tamanho e da complexidade do texto. Segmentos típicos (1–2 frases) são processados em 10–30 segundos.