Documentación

Referencia de API

Obtener resultados de clonación de voz

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

Consulta tras finalizar el proceso en segundo plano. Archivado independiente del éxito; fallo 422, no preparado o desconocido 409.

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

Parámetros de ruta

  • task_idstringObligatorio

    ID público de tarea creada con la misma clave.

Respuestas y errores

HTTP 200

Solicitud correcta.

application/json

Tipo
object
Campos obligatorios
idstatusresultusage
  • idstringObligatorio
  • statusstringObligatorio
    Enumeración
    ["succeeded"]
  • resultobjectObligatorio
    Campos secundarios de result (6)
    • file_idstringOpcional

      ID público de archivo gestionado de la misma cuenta y clave.

    • storage_statusstringOpcional

      Estado de archivado; descarga gestionada garantizada solo tras ready.

    • audio_urlstringObligatorio

      URL del audio generado; si está gestionado, el almacenamiento aporta URL firmada.

    • content_typestringOpcional

      Tipo MIME del resultado.

    • file_namestringOpcional

      Nombre público del archivo descargado.

    • file_sizeintegerOpcional

      Bytes del archivo de resultado.

  • usageobjectObligatorio
    Campos secundarios de usage (1)

HTTP 401

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

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto o capacidad no disponible.

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

Generación fallida.

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 502

Error en la respuesta del servicio.

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