# Requisição 1: Obter todos os modelos de voz
curl -X GET "https://app.talkover.ai/api/v1/voice-templates" \
  -H "Authorization: Bearer talq_your_environment_token_here"

// Requisição 1: Obter todos os modelos de voz
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here'
  }
});

const result = await response.json();
console.log(result);

{
  "success": true,
  "data": [
    {
      "display_name": "Bianca",
      "voices": [
        {
          "id": "voice-template-uuid-1",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "basic",
          "cost": "0.10"
        },
        {
          "id": "voice-template-uuid-2",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "pro",
          "cost": "0.16"
        },
        {
          "id": "voice-template-uuid-3",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "ultra",
          "cost": "0.23"
        }
      ]
    },
    {
      "display_name": "Isabela",
      "voices": [
        {
          "id": "voice-template-uuid-4",
          "name": "Isabela",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "basic",
          "cost": "0.10"
        },
        {
          "id": "voice-template-uuid-5",
          "name": "Isabela",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "pro",
          "cost": "0.16"
        }
      ]
    }
  ]
}

GET

api

voice-templates

# Requisição 1: Obter todos os modelos de voz
curl -X GET "https://app.talkover.ai/api/v1/voice-templates" \
  -H "Authorization: Bearer talq_your_environment_token_here"

// Requisição 1: Obter todos os modelos de voz
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here'
  }
});

const result = await response.json();
console.log(result);

{
  "success": true,
  "data": [
    {
      "display_name": "Bianca",
      "voices": [
        {
          "id": "voice-template-uuid-1",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "basic",
          "cost": "0.10"
        },
        {
          "id": "voice-template-uuid-2",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "pro",
          "cost": "0.16"
        },
        {
          "id": "voice-template-uuid-3",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "ultra",
          "cost": "0.23"
        }
      ]
    },
    {
      "display_name": "Isabela",
      "voices": [
        {
          "id": "voice-template-uuid-4",
          "name": "Isabela",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "basic",
          "cost": "0.10"
        },
        {
          "id": "voice-template-uuid-5",
          "name": "Isabela",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "pro",
          "cost": "0.16"
        }
      ]
    }
  ]
}

Listar Modelos de Voz

Recuperar uma lista de modelos de voz disponíveis agrupados por nome de exibição, com opções de filtragem por idioma, qualidade e gênero.

Endpoint

GET /api/v1/voice-templates

Cabeçalhos da requisição

string

obrigatório

Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

Parâmetros de consulta

string

Filtrar por idioma (ex: en-US, pt-BR)

string

Filtrar por nível de qualidade. Opções: basic, pro, ultra, beta

string

Filtrar por gênero. Opções: male, female

Exemplos de Requisição

# Requisição 1: Obter todos os modelos de voz
curl -X GET "https://app.talkover.ai/api/v1/voice-templates" \
  -H "Authorization: Bearer talq_your_environment_token_here"

// Requisição 1: Obter todos os modelos de voz
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here'
  }
});

const result = await response.json();
console.log(result);

# Requisição 2: Filtrar por idioma português
curl -X GET "https://app.talkover.ai/api/v1/voice-templates?language=pt-BR" \
  -H "Authorization: Bearer talq_your_environment_token_here"

// Requisição 2: Filtrar por idioma português
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates?language=pt-BR', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here'
  }
});

const result = await response.json();
console.log(result);

# Requisição 3: Filtrar por qualidade profissional e gênero feminino
curl -X GET "https://app.talkover.ai/api/v1/voice-templates?quality_tier=pro&gender=female" \
  -H "Authorization: Bearer talq_your_environment_token_here"

// Requisição 3: Filtrar por qualidade profissional e gênero feminino
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates?quality_tier=pro&gender=female', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here'
  }
});

const result = await response.json();
console.log(result);

Resposta

Resposta de Sucesso (200 OK)

{
  "success": true,
  "data": [
    {
      "display_name": "Bianca",
      "voices": [
        {
          "id": "voice-template-uuid-1",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "basic",
          "cost": "0.10"
        },
        {
          "id": "voice-template-uuid-2",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "pro",
          "cost": "0.16"
        },
        {
          "id": "voice-template-uuid-3",
          "name": "Bianca",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "ultra",
          "cost": "0.23"
        }
      ]
    },
    {
      "display_name": "Isabela",
      "voices": [
        {
          "id": "voice-template-uuid-4",
          "name": "Isabela",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "basic",
          "cost": "0.10"
        },
        {
          "id": "voice-template-uuid-5",
          "name": "Isabela",
          "gender": "female",
          "language": "pt-BR",
          "quality_tier": "pro",
          "cost": "0.16"
        }
      ]
    }
  ]
}

Campos da Resposta

boolean

obrigatório

Indica se a operação foi bem-sucedida.

array

obrigatório

Array de grupos de modelos de voz.

Mostrar Grupo de Modelos de Voz

string

obrigatório

Nome de exibição do grupo de vozes.

array

obrigatório

Array de modelos de voz individuais.

Mostrar Modelo de Voz

string

obrigatório

Identificador único do modelo de voz.

string

obrigatório

Nome do modelo de voz.

string

obrigatório

Gênero da voz. Opções: male, female.

string

obrigatório

Código do idioma da voz (ex: pt-BR, en-US).

string

obrigatório

Nível de qualidade da voz. Opções: basic, pro, ultra, beta.

string

obrigatório

Custo por minuto em USD.

Respostas de erro

401 Não Autorizado

{
  "success": false,
  "message": "Unauthorized"
}

422 Erro de Validação

{
  "success": false,
  "message": "The given data was invalid.",
  "errors": {
    "language": [
      "The selected language is invalid."
    ],
    "quality_tier": [
      "The selected quality tier is invalid."
    ],
    "gender": [
      "The selected gender is invalid."
    ]
  }
}

500 Erro do Servidor

{
  "success": false,
  "message": "Internal server error."
}

Códigos de erro

Código	Descrição	Status HTTP
`INVALID_TOKEN`	Token de autenticação inválido ou ausente	401
`VALIDATION_ERROR`	Validação dos parâmetros de consulta falhou	422
`SERVER_ERROR`	Erro interno do servidor ocorreu	500

Notas Importantes

Agrupamento por nome. Os modelos de voz são agrupados por nome de exibição para facilitar a seleção.

Filtros disponíveis. Use os parâmetros de consulta para filtrar por idioma, qualidade e gênero.

Custos variáveis. Cada nível de qualidade tem um custo diferente por minuto.

Melhores Práticas

Filtre por idioma - Use o parâmetro language para obter vozes no idioma desejado
Considere a qualidade - Escolha o nível de qualidade adequado para seu caso de uso
Teste as vozes - Use o endpoint de demonstração para testar as vozes antes de usar
Monitore custos - Diferentes níveis de qualidade têm custos diferentes
Trate erros - Implemente tratamento adequado de erros para falhas de autenticação e validação

Endpoints relacionados

Gerar Demonstração de Voz: GET /api/v1/voice-templates/{voice_template_id}/demo
Listar Números de Telefone: GET /api/v1/phone-numbers

Primeiros Passos

Conceitos

Referência da API

Guias

Listar Modelos de Voz

Listar Modelos de Voz

Endpoint

Cabeçalhos da requisição

Parâmetros de consulta

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

Respostas de erro

401 Não Autorizado

422 Erro de Validação

500 Erro do Servidor

Códigos de erro

Notas Importantes

Melhores Práticas

Endpoints relacionados

​Listar Modelos de Voz

​Endpoint

​Cabeçalhos da requisição

​Parâmetros de consulta

​Exemplos de Requisição

​Resposta

​Resposta de Sucesso (200 OK)

​Campos da Resposta

​Respostas de erro

​401 Não Autorizado

​422 Erro de Validação

​500 Erro do Servidor

​Códigos de erro

​Notas Importantes

​Melhores Práticas

​Endpoints relacionados

Listar Modelos de Voz

Endpoint

Cabeçalhos da requisição

Parâmetros de consulta

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

Respostas de erro

401 Não Autorizado

422 Erro de Validação

500 Erro do Servidor

Códigos de erro

Notas Importantes

Melhores Práticas

Endpoints relacionados