Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

Guide de développement

Ce guide vous aide à intégrer nos services API dans votre application.

Traitement asynchrone

Notre API utilise un modèle de traitement asynchrone :
  1. Soumettre une tâche : envoyer une requête de génération et recevoir un ID de tâche
  2. Interroger le statut : vérifier périodiquement le statut de la tâche
  3. Obtenir les résultats : récupérer les résultats de la génération une fois la tâche terminée

Exemple d’interrogation

import time

def wait_for_completion(client, task_id, max_wait=300):
    """Wait for the task to complete"""
    start_time = time.time()
    
    while time.time() - start_time < max_wait:
        result = client.tasks.get(task_id)
        
        if result.status == "completed":
            return result
        elif result.status == "failed":
            raise Exception(f"Task failed: {result.error}")
        
        time.sleep(2)  # wait 2 seconds before querying again
    
    raise Exception("Task timeout")

Gestion des erreurs

Erreurs courantes

StatutDescriptionSolution
400Paramètres de requête invalidesVérifiez les paramètres et le format de la requête
401Échec d’authentificationVérifiez votre clé API
402Solde insuffisantRechargez le solde de votre compte
429Limite de débit dépasséeRéduisez la fréquence des requêtes
500Erreur du serveurRéessayez plus tard

Exemple

try:
    response = client.images.generate(...)
except EvolinkError as e:
    if e.status_code == 401:
        print("Invalid API key")
    elif e.status_code == 402:
        print("Insufficient account balance")
    else:
        print(f"Error: {e.message}")

Bonnes pratiques

  1. Mise en cache : les liens d’images/vidéos générés sont valides 24 heures
  2. Nouvelles tentatives : implémentez un backoff exponentiel en cas d’erreurs transitoires
  3. Surveillance : vérifiez régulièrement l’utilisation de l’API et les quotas
  4. Sécurité : gardez votre clé API en sécurité

Support

Si vous rencontrez des problèmes pendant le développement, vous pouvez obtenir de l’aide via :
  • E-mail : [email protected]
  • Chat en direct : visitez notre site web
  • Documentation : consultez la documentation complète de l’API