Documentazione

Riferimento API

Crea un'attività di clonazione vocale

POST/v1/audio-clone/tasks

Usa TokenAuth ordinario; la quota esaurita può bloccare anche le consultazioni, diversamente da immagini/video persistenti. Creazione predefinita audio-clone-v1, interrogazioni in background. Non ripetere alla cieca invii sconosciuti.

Limiti di recupero delle attività di clonazione

La creazione del clone e le consultazioni successive usano l'autenticazione ordinaria. Riserva quota sufficiente e conserva la Key originale. Non presumere che la clonazione consenta consultazioni con una Key esaurita solo perché immagini o video lo permettono.

La clonazione non offre il recupero tramite chiave di richiesta delle immagini persistenti. Dopo un timeout di rete, conserva diagnostica e informazioni note sull'attività, poi verifica prima di reinviare. Valuta separatamente il successo dell'esecuzione e lo stato di salvataggio del risultato.

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

Header della richiesta

  • Idempotency-KeystringFacoltativo
    Lunghezza massima
    191
    Pattern
    "^[\\x20-\\x7E]{0,191}$"

Corpo della richiesta · application/json

Tipo
object
Campi obbligatori
textreference_audio_urlreference_text

Corpo della richiesta obbligatorio

  • modelstringFacoltativo

    ID pubblico del modello nel catalogo della Key corrente.

    Valore predefinito
    "audio-clone-v1"
    Enumerazione
    ["audio-clone-v1"]
  • textstringObbligatorio

    Testo da sintetizzare.

    Lunghezza minima
    1
    Lunghezza massima
    5000
  • reference_audio_urlstringObbligatorio

    URL HTTPS pubblico dell'audio di riferimento, senza informazioni utente e verificato contro SSRF.

  • reference_textstringObbligatorio

    Testo corrispondente all'audio di riferimento.

    Lunghezza minima
    1
    Lunghezza massima
    5000
  • remove_silencebooleanFacoltativoConsente null

    Rimozione del silenzio; true se omesso.

    Valore predefinito
    true

Risposte ed errori

HTTP 202

Attività accettata, non necessariamente completata.

application/json

Tipo
object
Campi obbligatori
idstatuscreated_at
  • idstringObbligatorio
  • statusstringObbligatorio
    Enumerazione
    ["queued"]
  • created_atintegerObbligatorio
    Formato
    "int64"

HTTP 400

Parametri della richiesta errati.

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 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 402

Quota disponibile dell'account o della Key insufficiente.

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 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
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 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 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"]