Skip to main content
La principale fonctionnalité de l’API Producer Tasks est de permettre la consultation de l’état d’exécution d’une tâche en entrant l’ID de tâche généré par l’API Producer Audios Generation. Ce document détaillera les instructions d’intégration de l’API Producer Tasks, vous aidant à intégrer facilement et à tirer pleinement parti de la puissance de cette API. Grâce à l’API Producer Tasks, vous pouvez facilement interroger l’état d’exécution des tâches de l’API Producer Audios Generation.

​
Processus de demande

Pour utiliser l’API Producer Audios Generation, commencez par obtenir votre jeton API sur le tableau de bord Ace Data Cloud pour le garder en réserve. Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion vous invitant à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle. Un jeton API suffit pour appeler tous les services de la plateforme, sans avoir besoin de demander séparément pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; lorsque le quota est insuffisant, vous pouvez recharger le solde général dans le tableau de bord.
📘 Documentation complète : API Producer Audios Generation →

​
Exemple de demande

L’API Producer Tasks peut être utilisée pour interroger les résultats de l’API Producer Audios Generation. Pour savoir comment utiliser l’API Producer Audios Generation, veuillez consulter la documentation API Producer Audios Generation. Prenons un exemple avec un ID de tâche retourné par le service API Producer Audios Generation, pour démontrer comment utiliser cette API. Supposons que nous ayons un ID de tâche : 1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad, nous allons maintenant démontrer comment procéder en passant cet ID de tâche.

​
Exemple de tâche

​
Configuration des en-têtes de demande et du corps de la demande

Request Headers inclut :
  • accept : spécifie que la réponse doit être au format JSON, ici rempli avec application/json.
  • authorization : la clé pour appeler l’API, que vous pouvez sélectionner directement après la demande.
Request Body inclut :
  • id : l’ID de la tâche téléchargée.
  • action : la manière d’opérer sur la tâche.
Configurez comme indiqué dans l’image ci-dessous :

​
Exemple de code

Vous pouvez constater que diverses langues de code ont déjà été générées automatiquement sur le côté droit de la page, comme le montre l’image :

Voici quelques exemples de code :

​
CURL

​
Exemple de réponse

Après une demande réussie, l’API renverra les détails de la tâche ici. Par exemple :
Le résultat de la réponse contient plusieurs champs, le champ request est le corps de la demande lors de l’initiation de la tâche, tandis que le champ response est le corps de la réponse retourné après l’achèvement de la tâche. Les descriptions des champs sont les suivantes.
  • id，générer l’ID de la tâche, utilisé pour identifier de manière unique cette tâche de génération.
  • request，informations de demande dans la tâche de requête.
  • response，informations de retour dans la tâche de requête.
  • created_at，date de création de la tâche, horodatage Unix (secondes, flottant).
  • started_at，date de début d’exécution de la tâche, horodatage Unix (secondes, flottant).
  • finished_at，date de fin de la tâche, horodatage Unix (secondes, flottant). Ce champ n’est pas retourné si la tâche n’est pas terminée.
  • elapsed，temps d’exécution de la tâche, en secondes (flottant, avec 3 décimales). Ce champ n’est pas retourné si la tâche n’est pas terminée.

​
Opération de requête en masse

Ceci est pour interroger les détails de plusieurs ID de tâches, contrairement à ce qui précède, il est nécessaire de sélectionner l’action comme retrieve_batch. Request Body comprend :
  • ids：tableau des ID de tâches téléchargés.
  • action：mode d’opération sur la tâche.
Réglez comme indiqué dans l’image ci-dessous :

​
Exemple de code

On peut constater qu’à droite de la page, divers langages de code ont déjà été générés automatiquement, comme le montre l’image :

Exemples de code partiels ci-dessous :

​
Exemple de réponse

Après une demande réussie, l’API renverra les détails spécifiques de toutes les tâches en masse. Par exemple :
Les résultats contiennent plusieurs champs, où les éléments incluent les détails spécifiques des tâches en lot, chaque tâche ayant des informations spécifiques au même format que le résultat de la requête d’une seule tâche ci-dessus, les informations des champs sont les suivantes.
  • items, tous les détails spécifiques des tâches en lot. C’est un tableau, chaque élément du tableau ayant le même format que le résultat de la requête d’une seule tâche ci-dessus.
  • count, le nombre de tâches dans cette requête en lot.

​
CURL

​
Gestion des erreurs

Lors de l’appel de l’API, si une erreur se produit, l’API renverra le code d’erreur et les informations correspondantes. Par exemple :
  • 400 token_mismatched : Mauvaise requête, probablement en raison de paramètres manquants ou invalides.
  • 400 api_not_implemented : Mauvaise requête, probablement en raison de paramètres manquants ou invalides.
  • 401 invalid_token : Non autorisé, jeton d’autorisation invalide ou manquant.
  • 429 too_many_requests : Trop de requêtes, vous avez dépassé la limite de taux.
  • 500 api_error : Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.

​
Exemple de réponse d’erreur

​
Conclusion

Grâce à ce document, vous avez compris comment utiliser l’API des tâches du producteur pour interroger les détails spécifiques d’une tâche unique ou en lot. Nous espérons que ce document vous aidera à mieux vous connecter et à utiliser cette API. Si vous avez des questions, n’hésitez pas à contacter notre équipe de support technique.