Documentation

Référence API

Obtenir le résultat du clonage vocal

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

À consulter après achèvement en arrière-plan. L'archivage du résultat est indépendant du succès. Échec : 422 ; non prêt ou inconnu : 409.

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

Paramètres de chemin

  • task_idstringObligatoire

    ID public d'une tâche créée avec la même Key.

Réponses et erreurs

HTTP 200

Requête réussie.

application/json

Type
object
Champs obligatoires
idstatusresultusage
  • idstringObligatoire
  • statusstringObligatoire
    Énumération
    ["succeeded"]
  • resultobjectObligatoire
    Sous-champs de result (6)
    • file_idstringFacultatif

      ID public du fichier hébergé du même compte et de la même Key.

    • storage_statusstringFacultatif

      État d'archivage du fichier ; le téléchargement hébergé est garanti seulement après ready.

    • audio_urlstringObligatoire

      Adresse d'accès à l'audio généré ; si hébergé, URL signée fournie par le stockage.

    • content_typestringFacultatif

      Type MIME du résultat.

    • file_namestringFacultatif

      Nom public du fichier téléchargé.

    • file_sizeintegerFacultatif

      Taille du fichier résultat en octets.

  • usageobjectObligatoire
    Sous-champs de usage (1)

HTTP 401

Key absente, invalide, expirée ou révoquée.

application/json

Type
object
Champs obligatoires
error

HTTP 403

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

application/json

Type
object
Champs obligatoires
error

HTTP 404

Objet ou capacité 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"]

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 422

Échec de génération.

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 502

Erreur de réponse du service.

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