Dokumentation

API-Referenz

Ergebnisse des Stimmenklonens abrufen

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

Nach Abschluss der Hintergrundverarbeitung abfragen. Ergebnisarchivierung ist vom Erfolg unabhängig. Fehler: 422; nicht bereit oder unbekannt: 409.

Authentifizierung und Berechtigungen

Verwenden Sie Ihren aktuellen GloopAPI-Schlüssel. Verfügbare Modelle, Funktionen und Berechtigungen hängen von seinem Katalog und der Endpunktdokumentation ab.

Authorization: Bearer $GLOOP_API_KEY

Authentifizierungsschemata: BearerAuth

Anfrage

Pfadparameter

  • task_idstringErforderlich

    Öffentliche ID einer mit demselben Schlüssel erstellten Aufgabe.

Antworten und Fehler

HTTP 200

Anfrage erfolgreich.

application/json

Typ
object
Pflichtfelder
idstatusresultusage
  • idstringErforderlich
  • statusstringErforderlich
    Aufzählung
    ["succeeded"]
  • resultobjectErforderlich
    Unterfelder von result (6)
    • file_idstringOptional

      Öffentliche ID einer verwalteten Datei desselben Kontos und Schlüssels.

    • storage_statusstringOptional

      Dateiarchivierungsstatus; verwaltete Downloads sind erst nach ready garantiert verfügbar.

    • audio_urlstringErforderlich

      Zugriffs-URL für generiertes Audio; bei verwalteter Speicherung liefert die Speicherschicht eine signierte URL.

    • content_typestringOptional

      MIME-Typ des Ergebnisses.

    • file_namestringOptional

      Öffentlicher Download-Dateiname.

    • file_sizeintegerOptional

      Größe der Ergebnisdatei in Bytes.

  • usageobjectErforderlich
    Unterfelder von usage (1)

HTTP 401

Key fehlt, ist ungültig, abgelaufen oder widerrufen.

application/json

Typ
object
Pflichtfelder
error

HTTP 403

Unzureichende IP-, Konto-, Modell- oder Tool-Berechtigungen.

application/json

Typ
object
Pflichtfelder
error

HTTP 404

Objekt oder Funktion nicht verfügbar.

application/json

Typ
object
Pflichtfelder
error
  • errorobjectErforderlich
    Unterfelder von error (3)
    • messagestringErforderlich
    • typestringErforderlich
      Aufzählung
      ["new_api_error"]
    • codestringErforderlich
      Aufzählung
      ["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

Anfragekonflikt, nicht bereit oder Übermittlung unbekannt. Zuerst den ursprünglichen Datensatz abfragen; nicht blind erneut senden.

application/json

Typ
object
Pflichtfelder
error
  • errorobjectErforderlich
    Unterfelder von error (3)
    • messagestringErforderlich
    • typestringErforderlich
      Aufzählung
      ["new_api_error"]
    • codestringErforderlich
      Aufzählung
      ["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

Generierung fehlgeschlagen.

application/json

Typ
object
Pflichtfelder
error
  • errorobjectErforderlich
    Unterfelder von error (3)
    • messagestringErforderlich
    • typestringErforderlich
      Aufzählung
      ["new_api_error"]
    • codestringErforderlich
      Aufzählung
      ["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

Anfrage-/Warteschlangenlimit.

application/json

Typ
object
Pflichtfelder
error

HTTP 500

Interner Authentifizierungs- oder Datenspeicherungsfehler.

application/json

Typ
object
Pflichtfelder
error

HTTP 502

Fehler in der Dienstantwort.

application/json

Typ
object
Pflichtfelder
error
  • errorobjectErforderlich
    Unterfelder von error (3)
    • messagestringErforderlich
    • typestringErforderlich
      Aufzählung
      ["new_api_error"]
    • codestringErforderlich
      Aufzählung
      ["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

Dienst, Speicherung, Preisberechnung vorübergehend nicht verfügbar.

application/json

Typ
object
Pflichtfelder
error
  • errorobjectErforderlich
    Unterfelder von error (3)
    • messagestringErforderlich
    • typestringErforderlich
      Aufzählung
      ["new_api_error"]
    • codestringErforderlich
      Aufzählung
      ["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"]
Bereit zum Entwickeln? Öffnen Sie Konsole um einen API-Schlüssel zu erstellen, oder durchsuchen Sie Funktionen.