Skip to main content
POST
Consulte detalhes do projeto, configurações editáveis, revisão dos segmentos, URLs de saída e versões de tradução.

Autenticação e permissões

string
obrigatório
Envie uma chave de API VoiceCheap neste cabeçalho. Authorization: Bearer com a mesma chave de API também é aceito. Tokens de acesso OAuth são aceitos apenas pelo MCP, não por este endpoint REST.
Permissões necessárias: projects:read. É necessária uma assinatura paga ativa. As permissões não alteram funções na equipe, propriedade dos recursos, créditos de mídia ou limites do plano.

Parâmetros

string
obrigatório
Valor de texto.Comprimento mínimo: 1. Comprimento máximo: 200. Padrão: ^[^/\\]+$.
O JSON Schema abaixo preserva os nomes exatos dos campos, tipos aninhados, valores padrão, limites e valores aceitos expostos pela descoberta. Regras adicionais entre campos são listadas nas notas da operação.

Exemplos de requisição

Substitua os identificadores de recursos e as chaves de mídia dos exemplos pelos valores retornados para sua conta. Mantenha o identificador da requisição ao tentar novamente a mesma alteração.

Resposta

Uma primeira execução bem-sucedida retorna HTTP 200 com o resultado da operação em data. Uma repetição pode retornar o estado salvo da requisição. O exemplo mostra uma resposta aceita, não todos os campos opcionais. Retorna os detalhes públicos do projeto, as configurações do cliente, a revisão atual da estrutura da fonte e todas as versões de saída traduzidas.

Campos do resultado

Notas da operação

  • Esta ação não retorna texto de transcrição nem documentos brutos de segmentos. Use transcripts_get para o conteúdo da transcrição e translations_list para os metadados dos trabalhos de idioma.
  • Campos aninhados opcionais ausentes são omitidos do JSON serializado. As URLs de saída são strings vazias até a saída correspondente estar disponível.
  • O status do projeto resume o fluxo de trabalho e a versão traduzida mais recente; inspecione cada entrada de translations[] ao gerenciar vários idiomas.
  • O campo error descreve uma falha de processamento armazenada; um projeto com falha recuperado com sucesso ainda retorna um resultado normal.
  • As falhas salvas retornam códigos de erro da VoiceCheap e mensagens fixas. Use o código e o estado atual do recurso para decidir como se recuperar.

Uso

Cada chamada bem-sucedida consome uma chamada mensal da API/MCP. Os créditos de mídia e as cotas de geração da própria operação também se aplicam.

Erros