Skip to main content
POST
Adicione à fila uma alteração coordenada dos tempos originais e traduzidos. Os tempos não podem se sobrepor a segmentos adjacentes ou a áudio ignorado. Consulte segment_actions_list.

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: transcription:write. É 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: ^[^/\\]+$.
integer
obrigatório
Valor inteiro.Mínimo: 0. Máximo: 9007199254740991.
string
Opcional na camada de transporte: o servidor insere um identificador antes da validação quando ele é omitido. Forneça seu próprio UUID v4 estável para recuperar com segurança uma resposta perdida.Formato: “uuid”. Padrão: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$.
number
obrigatório
Valor numérico.Mínimo: 0.
number
obrigatório
Valor numérico.
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.

Idempotência

Use um UUID v4 em requestId ou no cabeçalho HTTP Idempotency-Key para cada alteração. Reutilize o mesmo identificador e argumentos idênticos após uma falha de rede. Se ambos forem fornecidos, devem ser iguais. Repetir uma requisição salva não repete a operação nem consome outra chamada mensal. Requisições com falha ou interrompidas não são reiniciadas automaticamente. Qualquer alteração pode retornar HTTP 202 quando uma nova tentativa encontra a mesma requisição ainda em execução, mesmo que a primeira execução normalmente seja síncrona. Se a execução foi concluída, mas resultStored é false, uma nova tentativa retorna HTTP 200 com o estado salvo da requisição em vez do resultado original. Recupere a saída pela ação de histórico, resultado ou download do domínio correspondente.

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 admissão na fila de uma edição coordenada dos tempos de um segmento de origem e de seu segmento traduzido.

Campos do resultado

Recuperar e consultar esta requisição

Use o mesmo identificador mesmo após perder a conexão. Se resultStored for false, recupere a saída pela ação correspondente de histórico, resultado ou download. Nunca inicie uma segunda geração apenas para verificar o progresso.
HTTP 200

Notas da operação

  • Use um único requestId UUID v4 para a edição pretendida e reutilize-o com argumentos idênticos nas novas tentativas. jobId é igual a esse requestId.
  • A admissão retorna started ou queued, não a conclusão. Consulte periodicamente segment_actions_list e encontre items[].id igual a jobId até completed, failed ou cancelled; depois atualize transcripts_get e projects_get.
  • queue.revision acompanha o estado da fila; não é uma revisão da estrutura de segmentos de origem. As ações de fila capturam a estrutura atual na admissão. Uma alteração estrutural incompatível posterior pode fazer o item falhar com SEGMENT_STRUCTURE_CHANGED.
  • Somente uma ação pendente para o mesmo alvo lógico de segmento é admitida. Um novo requestId não contorna SEGMENT_ACTION_ALREADY_PENDING.
  • Falhas de execução da fila aparecem como items[].status failed junto com errorCode, sem alterar o resultado bem-sucedido do envio.
  • begin e end estão em segundos; begin deve ser não negativo e end maior que begin. O worker arredonda para milissegundos e exige uma duração de pelo menos 0.1 segundos.
  • O worker verifica os segmentos de origem vizinhos atualizados e os intervalos ignorados. Segmentos adjacentes do mesmo locutor não podem se sobrepor nem compartilhar um limite; sobreposição com intervalos ignorados na tradução é rejeitada.
  • Os tempos de origem e os correspondentes traduzidos disponíveis são atualizados juntos. Trabalhos de idioma que ainda aguardam revisão são ignorados nas atualizações dos tempos traduzidos.
  • Um erro de temporização encontrado pelo worker é informado como um item de fila com falha, geralmente com ACTION_REJECTED, em vez de uma resposta de admissão com falha.
  • 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