Saltar al contenido 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.

Guía de desarrollo

Esta guía le ayuda a integrar nuestros servicios de API en su aplicación.

Procesamiento asíncrono

Nuestra API utiliza un modelo de procesamiento asíncrono:
  1. Enviar una tarea: envíe una solicitud de generación y reciba un ID de tarea
  2. Consultar estado: revise periódicamente el estado de la tarea
  3. Obtener resultados: recupere los resultados de la generación cuando la tarea se complete

Ejemplo de polling

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

Manejo de errores

Errores comunes

EstadoDescripciónResolución
400Parámetros de solicitud no válidosRevise los parámetros y el formato de la solicitud
401Error de autenticaciónVerifique su clave de API
402Saldo insuficienteRecargue el saldo de su cuenta
429Límite de tasa superadoReduzca la frecuencia de las solicitudes
500Error del servidorReintente más tarde

Ejemplo

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

Buenas prácticas

  1. Almacenamiento en caché: los enlaces a imágenes/videos generados son válidos durante 24 horas
  2. Reintentos: implemente backoff exponencial ante errores transitorios
  3. Supervisión: revise regularmente el uso y las cuotas de la API
  4. Seguridad: mantenga su clave de API segura

Soporte

Si encuentra problemas durante el desarrollo, puede obtener ayuda a través de:
  • Correo electrónico: zhihong@apimart.ai
  • Chat en vivo: visite nuestro sitio web
  • Documentación: consulte la documentación completa de la API