Skip to main content
POST
Consulte ações de edição ou regeneração de segmentos de um projeto que estão na fila, em execução ou concluídas.

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 a revisão atual da fila do projeto e os itens públicos de ação queued, running e em estado terminal.

Campos do resultado

Notas da operação

  • Consulte periodicamente items[].id correspondente ao jobId retornado por segments_text_update, segments_timestamps_update ou segments_regenerate. completed, failed e cancelled são estados terminais.
  • revision é a revisão da fila, não a segmentStructureRevision de origem exigida para exclusão ou mesclagem.
  • Uma ação pode retornar um envio bem-sucedido e falhar posteriormente na fila. Inspecione items[].errorCode; atualize o estado do projeto, da transcrição e da saída afetados antes de decidir sobre uma nova ação.
  • Esta operação não tem entrada de paginação. Um projeto sem fila retorna projectId, revision 0 e um array items vazio.
  • As respostas da fila, incluindo envio, cancelamento, consulta e repetição, contêm apenas metadados das ações. Leia o conteúdo da transcrição com transcripts_get e a permissão necessária transcription:read.

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