Referência da API

Criar tarefa de clonagem de voz

POST/v1/audio-clone/tasks

Usa TokenAuth comum; consultas podem ser rejeitadas com cota esgotada, ao contrário da autenticação flexível de imagens/vídeos persistentes. A criação usa audio-clone-v1 por padrão e consulta em segundo plano. Nunca reenvie às cegas envios desconhecidos.

Limites de recuperação da clonagem

Criação e consultas de clonagem usam autenticação comum. Reserve cota suficiente e preserve a chave original. Não presuma que a clonagem aceita consultas com cota esgotada só porque imagens e vídeos aceitam.

Clonagem não tem recuperação por chave de solicitação equivalente à de imagens persistentes. Após timeout de rede, preserve diagnósticos e informações conhecidas e investigue a tarefa antes de continuar; não reenvie às cegas. Avalie separadamente o sucesso e o salvamento do resultado.

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

Cabeçalhos da solicitação

Idempotency-KeystringOpcional
Comprimento máximo
191
Padrão
"^[\\x20-\\x7E]{0,191}$"

Corpo da solicitação · application/json

Tipo: object
Campos obrigatórios: textreference_audio_urlreference_text

Corpo da solicitação obrigatório

modelstringOpcional
ID público do modelo no catálogo da chave atual.

Valor padrão
"audio-clone-v1"
Enumeração
["audio-clone-v1"]
textstringObrigatório
Texto a sintetizar.

Comprimento mínimo
1
Comprimento máximo
5000
reference_audio_urlstringObrigatório
URL HTTPS pública de áudio de referência; proíbe informações de usuário e valida SSRF.
reference_textstringObrigatório
Texto correspondente ao áudio de referência.

Comprimento mínimo
1
Comprimento máximo
5000
remove_silencebooleanOpcionalPermite null
Se remove silêncio; omitido usa true.

Valor padrão
true

Respostas e erros

HTTP 202

Tarefa aceita; não significa concluída.

application/json

Tipo: object
Campos obrigatórios: idstatuscreated_at

idstringObrigatório
statusstringObrigatório
Enumeração
["queued"]
created_atintegerObrigatório
Formato
"int64"

HTTP 400

Parâmetros de solicitação incorretos.

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 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 402

Cota disponível insuficiente na conta ou chave.

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 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 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 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 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"]