Referência da API

Obter resultados de clonagem de voz

GET/v1/audio-clone/tasks/{task_id}/result

Consulte após a conclusão em segundo plano. Arquivamento independe do sucesso; falha 422, não pronto ou desconhecido 409.

Autenticação e permissões

Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticação: BearerAuth

Solicitação

Parâmetros de caminho

task_idstringObrigatório
ID público da tarefa criada com a mesma chave.

Respostas e erros

HTTP 200

Solicitação bem-sucedida.

application/json

Tipo: object
Campos obrigatórios: idstatusresultusage

idstringObrigatório
statusstringObrigatório
Enumeração
["succeeded"]
resultobjectObrigatório
Campos filhos de result (6)
- file_idstringOpcional
  ID público de arquivo gerenciado da mesma conta e chave.
- storage_statusstringOpcional
  Status de arquivamento; download gerenciado garantido apenas após ready.
- audio_urlstringObrigatório
  URL do áudio gerado; se gerenciado, o armazenamento fornece URL assinada.
- content_typestringOpcional
  Tipo MIME do resultado.
- file_namestringOpcional
  Nome público do arquivo baixado.
- file_sizeintegerOpcional
  Bytes do arquivo de resultado.
usageobjectObrigatório
Campos filhos de usage (1)
- charactersintegerObrigatório
  Mínimo
  0

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 404

Objeto ou recurso indisponível.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (3)
- messagestringObrigatório
- typestringObrigatório
  Enumeração
  ["new_api_error"]
- codestringObrigatório
  Enumeração
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 409

Conflito, não pronto ou envio desconhecido; consulte o original primeiro, sem reenviar às cegas.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (3)
- messagestringObrigatório
- typestringObrigatório
  Enumeração
  ["new_api_error"]
- codestringObrigatório
  Enumeração
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 422

Geração falhou.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (3)
- messagestringObrigatório
- typestringObrigatório
  Enumeração
  ["new_api_error"]
- codestringObrigatório
  Enumeração
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 429

Limite de solicitações/fila.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 502

Erro na resposta do serviço.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (3)
- messagestringObrigatório
- typestringObrigatório
  Enumeração
  ["new_api_error"]
- codestringObrigatório
  Enumeração
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 503

Serviço, armazenamento, preços temporariamente indisponíveis.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (3)
- messagestringObrigatório
- typestringObrigatório
  Enumeração
  ["new_api_error"]
- codestringObrigatório
  Enumeração
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]