Documentazione

Riferimento API

Ottieni il risultato della clonazione vocale

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

Da consultare dopo il completamento in background. L'archiviazione del risultato è indipendente dal successo. Errore: 422; non pronto o sconosciuto: 409.

Autenticazione e autorizzazioni

Usa la chiave GloopAPI corrente. Modelli, funzionalità e autorizzazioni disponibili dipendono dal relativo catalogo e dalla documentazione dell'endpoint.

Authorization: Bearer $GLOOP_API_KEY

Schemi di autenticazione: BearerAuth

Richiesta

Parametri del percorso

  • task_idstringObbligatorio

    ID pubblico di un'attività creata con la stessa Key.

Risposte ed errori

HTTP 200

Richiesta riuscita.

application/json

Tipo
object
Campi obbligatori
idstatusresultusage
  • idstringObbligatorio
  • statusstringObbligatorio
    Enumerazione
    ["succeeded"]
  • resultobjectObbligatorio
    Campi figli di result (6)
    • file_idstringFacoltativo

      ID pubblico del file ospitato dello stesso account e della stessa Key.

    • storage_statusstringFacoltativo

      Stato di archiviazione del file; il download ospitato è garantito solo dopo ready.

    • audio_urlstringObbligatorio

      Indirizzo dell'audio generato; se ospitato, URL firmato fornito dallo storage.

    • content_typestringFacoltativo

      Tipo MIME del risultato.

    • file_namestringFacoltativo

      Nome pubblico del file scaricato.

    • file_sizeintegerFacoltativo

      Dimensione del file risultato in byte.

  • usageobjectObbligatorio
    Campi figli di usage (1)

HTTP 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
error

HTTP 404

Oggetto o funzionalità non disponibile.

application/json

Tipo
object
Campi obbligatori
error
  • errorobjectObbligatorio
    Campi figli di error (3)
    • messagestringObbligatorio
    • typestringObbligatorio
      Enumerazione
      ["new_api_error"]
    • codestringObbligatorio
      Enumerazione
      ["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

Conflitto, risultato non pronto o invio sconosciuto: consulta prima il record originale, senza reinvii alla cieca.

application/json

Tipo
object
Campi obbligatori
error
  • errorobjectObbligatorio
    Campi figli di error (3)
    • messagestringObbligatorio
    • typestringObbligatorio
      Enumerazione
      ["new_api_error"]
    • codestringObbligatorio
      Enumerazione
      ["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

Generazione non riuscita.

application/json

Tipo
object
Campi obbligatori
error
  • errorobjectObbligatorio
    Campi figli di error (3)
    • messagestringObbligatorio
    • typestringObbligatorio
      Enumerazione
      ["new_api_error"]
    • codestringObbligatorio
      Enumerazione
      ["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 di frequenza delle richieste/della coda.

application/json

Tipo
object
Campi obbligatori
error

HTTP 500

Errore interno di autenticazione o storage dei dati.

application/json

Tipo
object
Campi obbligatori
error

HTTP 502

Errore nella risposta del servizio.

application/json

Tipo
object
Campi obbligatori
error
  • errorobjectObbligatorio
    Campi figli di error (3)
    • messagestringObbligatorio
    • typestringObbligatorio
      Enumerazione
      ["new_api_error"]
    • codestringObbligatorio
      Enumerazione
      ["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

Servizio, storage, prezzi temporaneamente non disponibile.

application/json

Tipo
object
Campi obbligatori
error
  • errorobjectObbligatorio
    Campi figli di error (3)
    • messagestringObbligatorio
    • typestringObbligatorio
      Enumerazione
      ["new_api_error"]
    • codestringObbligatorio
      Enumerazione
      ["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"]