Documentation

Référence API

Créer une tâche de clonage vocal

POST/v1/audio-clone/tasks

Utilise TokenAuth ordinaire ; un quota épuisé peut aussi bloquer les consultations, contrairement aux images/vidéos persistantes. Création avec audio-clone-v1 par défaut, interrogation en arrière-plan. Ne répétez pas aveuglément une soumission inconnue.

Limites de récupération des tâches de clonage

La création d'un clonage et les consultations suivantes utilisent l'authentification ordinaire. Prévoyez un quota suffisant et conservez la Key d'origine. Ne supposez pas que le clonage accepte une Key épuisée simplement parce que les images ou vidéos le permettent.

Le clonage n'offre pas la récupération par clé de requête des images persistantes. Après un délai réseau dépassé, conservez les diagnostics et les informations connues sur la tâche, puis vérifiez-la avant toute nouvelle soumission. Évaluez séparément la réussite de l'exécution et l'état de sauvegarde du résultat.

Authentification et autorisations

Utilisez votre clé GloopAPI actuelle. Les modèles, capacités et autorisations disponibles dépendent de son catalogue et de la documentation du point de terminaison.

Authorization: Bearer $GLOOP_API_KEY

Schémas d'authentification : BearerAuth

Requête

En-têtes de requête

  • Idempotency-KeystringFacultatif
    Longueur maximale
    191
    Motif
    "^[\\x20-\\x7E]{0,191}$"

Corps de requête · application/json

Type
object
Champs obligatoires
textreference_audio_urlreference_text

Corps de requête obligatoire

  • modelstringFacultatif

    ID public du modèle dans le catalogue de la Key actuelle.

    Valeur par défaut
    "audio-clone-v1"
    Énumération
    ["audio-clone-v1"]
  • textstringObligatoire

    Texte à synthétiser.

    Longueur minimale
    1
    Longueur maximale
    5000
  • reference_audio_urlstringObligatoire

    URL HTTPS publique d'audio de référence, sans informations utilisateur et vérifiée contre SSRF.

  • reference_textstringObligatoire

    Texte correspondant à l'audio de référence.

    Longueur minimale
    1
    Longueur maximale
    5000
  • remove_silencebooleanFacultatifAutorise null

    Suppression du silence ; true si omis.

    Valeur par défaut
    true

Réponses et erreurs

HTTP 202

Tâche acceptée, pas nécessairement terminée.

application/json

Type
object
Champs obligatoires
idstatuscreated_at
  • idstringObligatoire
  • statusstringObligatoire
    Énumération
    ["queued"]
  • created_atintegerObligatoire
    Format
    "int64"

HTTP 400

Paramètres de requête incorrects.

application/json

Type
object
Champs obligatoires
error
  • errorobjectObligatoire
    Sous-champs de error (3)
    • messagestringObligatoire
    • typestringObligatoire
      Énumération
      ["new_api_error"]
    • codestringObligatoire
      Énumération
      ["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 absente, invalide, expirée ou révoquée.

application/json

Type
object
Champs obligatoires
error

HTTP 402

Quota disponible du compte ou de la Key insuffisant.

application/json

Type
object
Champs obligatoires
error
  • errorobjectObligatoire
    Sous-champs de error (3)
    • messagestringObligatoire
    • typestringObligatoire
      Énumération
      ["new_api_error"]
    • codestringObligatoire
      Énumération
      ["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

Autorisations IP, compte, modèle ou outil insuffisantes.

application/json

Type
object
Champs obligatoires
error

HTTP 409

Conflit, résultat non prêt ou soumission inconnue : consultez d'abord l'enregistrement initial, sans répétition aveugle.

application/json

Type
object
Champs obligatoires
error
  • errorobjectObligatoire
    Sous-champs de error (3)
    • messagestringObligatoire
    • typestringObligatoire
      Énumération
      ["new_api_error"]
    • codestringObligatoire
      Énumération
      ["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

Limitation de débit des requêtes/de la file.

application/json

Type
object
Champs obligatoires
error

HTTP 500

Défaillance interne d'authentification ou de stockage des données.

application/json

Type
object
Champs obligatoires
error

HTTP 503

Service, stockage, tarification temporairement indisponible.

application/json

Type
object
Champs obligatoires
error
  • errorobjectObligatoire
    Sous-champs de error (3)
    • messagestringObligatoire
    • typestringObligatoire
      Énumération
      ["new_api_error"]
    • codestringObligatoire
      Énumération
      ["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"]