Zum Hauptinhalt springen

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.

Entwicklungsleitfaden

Dieser Leitfaden hilft Ihnen, unsere API-Dienste in Ihre Anwendung zu integrieren.

Asynchrone Verarbeitung

Unsere API verwendet ein asynchrones Verarbeitungsmodell:
  1. Aufgabe einreichen: Senden Sie eine Generierungsanfrage und erhalten Sie eine Aufgaben-ID
  2. Status abfragen: Prüfen Sie regelmäßig den Status der Aufgabe
  3. Ergebnis abrufen: Holen Sie das Generierungsergebnis ab, sobald die Aufgabe abgeschlossen ist

Beispiel zum Abfragen

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

Fehlerbehandlung

Häufige Fehler

StatusBeschreibungLösung
400Ungültige AnfrageparameterPrüfen Sie Parameter und Format der Anfrage
401Authentifizierung fehlgeschlagenAPI-Schlüssel überprüfen
402Unzureichendes GuthabenKontoguthaben aufladen
429Rate Limit überschrittenAnfragenrate reduzieren
500ServerfehlerSpäter erneut versuchen

Beispiel

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}")

Best Practices

  1. Caching: Generierte Bild-/Videolinks sind 24 Stunden gültig
  2. Wiederholungen: Implementieren Sie exponentielles Backoff bei vorübergehenden Fehlern
  3. Monitoring: Prüfen Sie regelmäßig API-Nutzung und Kontingente
  4. Sicherheit: Bewahren Sie Ihren API-Schlüssel sicher auf

Support

Wenn Sie während der Entwicklung auf Probleme stoßen, erhalten Sie Hilfe über:
  • E-Mail: [email protected]
  • Live-Chat: Besuchen Sie unsere Website
  • Dokumentation: Durchsuchen Sie die vollständige API-Dokumentation