Google Text-to-Speech

Conversão de texto em voz neural da Google com vozes WaveNet. Mais de 380 vozes em mais de 50 idiomas com suporte SSML.

Autenticação

Para aceder ao Google TTS através da API Doitong, utilize a sua chave de API Doitong. Inclua-a na mutação GraphQL ou nos cabeçalhos da API REST.

// GraphQL Header
{
  "Authorization": "Bearer YOUR_API_KEY"
}

// REST Header
"X-API-Key": "YOUR_API_KEY"

Início Rápido

Comece a utilizar o Google TTS API em apenas alguns minutos. Siga estes passos simples para gerar o seu primeiro tts.

Passo 1: Obter a sua Chave de API

Registe uma conta Doitong e aceda ao seu painel de controlo para gerar uma chave de API.

Passo 2: Fazer o seu Primeiro Pedido

Utilize um dos exemplos de código abaixo para realizar a sua primeira chamada de API.

curl -X POST https://api.doitong.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "query": "mutation Generate($input: GenerateInput!) { generate(input: $input) { id status type provider url metadata creditCost } }",
    "variables": {
      "input": {
        "type": "AUDIO",
        "provider": "google-tts",
        "input": {
          "text": "Hello world, this is a text to speech example.",
          "voice": "en-US-neural"
        },
        "options": {
          "speed": 1.0
        }
      }
    }
  }'

const response = await fetch('https://api.doitong.com/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    query: `
      mutation GenerateSpeech($input: TTSInput!) {
        generateSpeech(input: $input) {
          id
          audioUrl
          duration
        }
      }
    `,
    variables: {
      input: {
        service: 'google-tts',
        text: 'Hello world, this is a text to speech example.',
        voice: 'en-US-neural',
        speed: 1.0
      }
    }
  })
});

const data = await response.json();
console.log('Result:', data.data.generate);

import requests
import json

url = "https://api.doitong.com/graphql"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

query = """
mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
  }
}
"""

variables = {
    "input": {
        "type": "AUDIO",
        "provider": "google-tts",
        "input": {
            "text": "Hello world, this is a text to speech example.",
            "voice": "en-US-neural"
        },
        "options": {
            "speed": 1.0
        }
    }
}

response = requests.post(url, json={
    "query": query,
    "variables": variables
}, headers=headers)

data = response.json()
print("Result:", data["data"]["generate"])

mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
    createdAt
  }
}

# Variables
{
  "input": {
    "type": "AUDIO",
    "provider": "google-tts",
    "input": {
      "text": "Hello world, this is a text to speech example.",
      "voice": "en-US-neural"
    },
    "options": {
      "speed": 1.0,
      "pitch": 1.0,
      "language": "en",
      "version": "neural2"
    }
  }
}

Preçário

O Google TTS API utiliza um modelo de preços baseado em créditos. Os créditos são consumidos com base na complexidade e duração do conteúdo gerado.

Endpoints da API

O Google TTS API está disponível através do nosso endpoint GraphQL unificado.

Endpoint GraphQL

POST https://api.doitong.com/graphql

Endpoint REST

POST https://api.doitong.com/v1/tts

Parâmetros

Parâmetros disponíveis para pedidos Google TTS API:

Formato da Resposta

Todas as respostas da API seguem um formato consistente:

Resposta de Sucesso

{
  "data": {
    "tts": {
      "id": "abc123xyz",
      "status": "processing",
      "url": null,
      "webhookUrl": "https://your-webhook.com/callback",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Resposta Concluída

{
  "data": {
    "tts": {
      "id": "abc123xyz",
      "status": "completed",
      "url": "https://cdn.doitong.com/outputs/abc123xyz.mp3",
      "duration": null,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Tratamento de Erros

A API utiliza códigos de estado HTTP padrão e devolve mensagens de erro detalhadas.

Códigos de Erro Comuns

Formato de Resposta de Erro

{
  "errors": [
    {
      "message": "Insufficient credits for this operation",
      "extensions": {
        "code": "INSUFFICIENT_CREDITS",
        "creditsRequired": 100,
        "creditsAvailable": 50
      }
    }
  ]
}

Webhooks

Receba notificações em tempo real quando a geração do seu tts estiver concluída.

Configurar Webhooks

Include a <code>webhookUrl</code> parameter in your request to receive a POST notification when processing is complete.

Payload do Webhook

{
  "id": "abc123xyz",
  "status": "completed",
  "url": "https://cdn.doitong.com/outputs/abc123xyz.mp3",
  "service": "google-tts",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": null,
    "width": null,
    "height": null
  }
}

Segurança do Webhook

Todos os pedidos de webhook incluem um cabeçalho de assinatura para verificação:

X-Doitong-Signature: sha256=abc123...

Limites de Pedidos

Para garantir uma utilização justa e a estabilidade do sistema, aplicam-se os seguintes limites:

Boas Práticas

1. Otimize os seus Prompts

Escreva prompts claros e descritivos para obter os melhores resultados:

• Be specific about visual elements, style, and mood
• Include details about lighting, camera angles, and composition
• Avoid contradictory or impossible requests

2. Gestão de Processamento Assíncrono

A geração é assíncrona. Implemente webhooks ou polling adequados:

// Polling example
async function pollStatus(jobId) {
  let status = 'processing';
  while (status === 'processing') {
    await sleep(2000); // Wait 2 seconds
    const result = await checkJobStatus(jobId);
    status = result.status;
  }
  return result;
}

3. Recuperação de Erros

Implemente lógica de repetição com backoff exponencial:

async function retryWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

4. Monitorizar Consumo de Créditos

Acompanhe o seu consumo de créditos para evitar interrupções:

• Check credit balance before large batch operations
• Set up alerts for low credit thresholds
• Implement credit-aware request queuing

Pronto para Começar?

Junte-se a milhares de programadores que utilizam o Google TTS API para criar conteúdo incrível