Saltar para o conteúdo 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.

Guia de desenvolvimento

Este guia ajuda você a integrar nossos serviços de API em sua aplicação.

Processamento assíncrono

Nossa API utiliza um modelo de processamento assíncrono:
  1. Envie uma tarefa: faça uma requisição de geração e receba um ID de tarefa
  2. Consulte o status: verifique periodicamente o status da tarefa
  3. Obtenha os resultados: busque os resultados da geração quando a tarefa for concluída

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

Tratamento de erros

Erros comuns

StatusDescriçãoResolução
400Parâmetros de requisição inválidosVerifique os parâmetros e o formato da requisição
401Falha na autenticaçãoVerifique sua chave de API
402Saldo insuficienteRecarregue o saldo da sua conta
429Limite de taxa excedidoReduza a frequência de requisições
500Erro do servidorTente novamente mais tarde

Exemplo

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

Boas práticas

  1. Cache: links de imagens/vídeos gerados são válidos por 24 horas
  2. Tentativas: implemente backoff exponencial em erros transitórios
  3. Monitoramento: verifique regularmente o uso e as cotas da API
  4. Segurança: mantenha sua chave de API protegida

Suporte

Se você encontrar problemas durante o desenvolvimento, pode obter ajuda através de:
  • E-mail: zhihong@apimart.ai
  • Chat ao vivo: visite nosso site
  • Documentação: navegue pela documentação completa da API