Documentación

Referencia de API

Crear tarea de clonación de voz

POST/v1/audio-clone/tasks

Usa TokenAuth ordinario; las consultas pueden rechazarse si la cuota se agota, a diferencia de la autenticación flexible de imágenes/vídeos persistentes. La creación usa audio-clone-v1 por defecto y consulta en segundo plano. No reenvíes a ciegas envíos desconocidos.

Límites de recuperación de la clonación

La creación y las consultas de clonación usan autenticación ordinaria. Reserva cuota suficiente y conserva la clave original. No supongas que la clonación permite consultar con cuota agotada porque imágenes y vídeos sí lo hagan.

La clonación no tiene recuperación por clave de solicitud equivalente a imágenes persistentes. Tras un tiempo de espera de red, conserva diagnósticos e información conocida, e investiga la tarea antes de continuar; no reenvíes a ciegas. Evalúa por separado el éxito y el guardado del resultado.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Encabezados de solicitud

  • Idempotency-KeystringOpcional
    Longitud máxima
    191
    Patrón
    "^[\\x20-\\x7E]{0,191}$"

Cuerpo de solicitud · application/json

Tipo
object
Campos obligatorios
textreference_audio_urlreference_text

Cuerpo de solicitud obligatorio

  • modelstringOpcional

    ID público de modelo del catálogo de la clave actual.

    Valor predeterminado
    "audio-clone-v1"
    Enumeración
    ["audio-clone-v1"]
  • textstringObligatorio

    Texto que sintetizar.

    Longitud mínima
    1
    Longitud máxima
    5000
  • reference_audio_urlstringObligatorio

    URL HTTPS pública de audio de referencia; prohíbe información de usuario y valida SSRF.

  • reference_textstringObligatorio

    Texto correspondiente al audio de referencia.

    Longitud mínima
    1
    Longitud máxima
    5000
  • remove_silencebooleanOpcionalAdmite null

    Si se elimina silencio; omitido usa true.

    Valor predeterminado
    true

Respuestas y errores

HTTP 202

Tarea aceptada; no significa completada.

application/json

Tipo
object
Campos obligatorios
idstatuscreated_at
  • idstringObligatorio
  • statusstringObligatorio
    Enumeración
    ["queued"]
  • created_atintegerObligatorio
    Formato
    "int64"

HTTP 400

Parámetros de solicitud incorrectos.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio
      Enumeración
      ["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

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 402

Cuota disponible insuficiente en cuenta o clave.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio
      Enumeración
      ["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

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto, no preparado o envío desconocido; consulta primero el original, sin reenviar a ciegas.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio
      Enumeración
      ["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

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 503

Servicio, almacenamiento, precios temporalmente no disponibles.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio
      Enumeración
      ["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"]