Перейти к основному содержанию

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.

Руководство разработчика

Это руководство поможет вам интегрировать наши API-сервисы в ваше приложение.

Асинхронная обработка

Наш API использует асинхронную модель обработки:
  1. Отправьте задачу: пошлите запрос на генерацию и получите ID задачи
  2. Опрашивайте статус: периодически проверяйте статус задачи
  3. Получите результат: заберите результат генерации после завершения задачи

Пример опроса

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

Обработка ошибок

Распространённые ошибки

СтатусОписаниеРешение
400Некорректные параметры запросаПроверьте параметры и формат запроса
401Ошибка аутентификацииПроверьте API-ключ
402Недостаточно средствПополните баланс аккаунта
429Превышен лимит запросовУменьшите частоту запросов
500Ошибка сервераПовторите попытку позже

Пример

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

Лучшие практики

  1. Кэширование: ссылки на сгенерированные изображения/видео действительны 24 часа
  2. Повторы: реализуйте экспоненциальный откат при временных ошибках
  3. Мониторинг: регулярно проверяйте использование API и квоты
  4. Безопасность: храните API-ключ в секрете

Поддержка

Если у вас возникли проблемы в процессе разработки, вы можете получить помощь через:
  • Email: zhihong@apimart.ai
  • Онлайн-чат: посетите наш сайт
  • Документация: ознакомьтесь с полной документацией API