API-Referenz

Aufgabe zum Klonen einer Stimme erstellen

POST/v1/audio-clone/tasks

Verwendet normales TokenAuth; ausgeschöpftes Kontingent kann auch Abfragen blockieren, anders als bei persistenten Bildern/Videos. Erstellung standardmäßig mit audio-clone-v1, Hintergrundabfragen. Unbekannte Übermittlungen nicht blind wiederholen.

Grenzen der Wiederherstellung von Klonaufgaben

Erstellung und spätere Abfragen von Klonaufgaben verwenden normale Authentifizierung. Halten Sie ausreichend Kontingent vor und bewahren Sie die ursprüngliche Key auf. Gehen Sie nicht davon aus, dass Klonen Abfragen mit ausgeschöpfter Key erlaubt, nur weil Bilder oder Videos dies tun.

Klonen besitzt keinen Wiederherstellungsendpunkt nach Anfrageschlüssel wie persistente Bilder. Bewahren Sie nach einem Netzwerk-Timeout Diagnosen und bekannte Aufgabeninformationen auf und prüfen Sie die Aufgabe vor einer erneuten Einreichung. Bewerten Sie auch erfolgreiche Ausführung und Speicherstatus des Ergebnisses getrennt.

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

Anfrageheader

Idempotency-KeystringOptional
Maximale Länge
191
Muster
"^[\\x20-\\x7E]{0,191}$"

Anfragekörper · application/json

Typ: object
Pflichtfelder: textreference_audio_urlreference_text

Anfragekörper erforderlich

modelstringOptional
Öffentliche Modell-ID aus dem Katalog des aktuellen Schlüssels.

Standardwert
"audio-clone-v1"
Aufzählung
["audio-clone-v1"]
textstringErforderlich
Zu synthetisierender Text.

Mindestlänge
1
Maximale Länge
5000
reference_audio_urlstringErforderlich
Öffentliche HTTPS-URL für Referenzaudio, ohne Benutzerinformationen und SSRF-geprüft.
reference_textstringErforderlich
Zum Referenzaudio gehörender Text.

Mindestlänge
1
Maximale Länge
5000
remove_silencebooleanOptionalErlaubt null
Ob Stille entfernt wird; bei Auslassung true.

Standardwert
true

Antworten und Fehler

HTTP 202

Aufgabe angenommen, nicht zwangsläufig abgeschlossen.

application/json

Typ: object
Pflichtfelder: idstatuscreated_at

idstringErforderlich
statusstringErforderlich
Aufzählung
["queued"]
created_atintegerErforderlich
Format
"int64"

HTTP 400

Ungültige Anfrageparameter.

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 401

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

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

HTTP 402

Verfügbares Kontingent des Kontos oder Schlüssels reicht nicht aus.

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 403

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

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

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 429

Anfrage-/Warteschlangenlimit.

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

HTTP 500

Interner Authentifizierungs- oder Datenspeicherungsfehler.

application/json

Typ: object
Pflichtfelder: error

errorobjectErforderlich
Unterfelder von error (4)
- codestringOptional
- messagestringOptional
- typestringOptional
- request_idstringOptional

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