Skip to content

Как использовать API

AiHere API создано для программного доступа к генеративным моделям: изображений (Nano Banana 2/Pro, Seedream 4.5, Flux, GPT Image, Grok Imagine, Recraft, Wan), видео (Veo 3, Kling 2.6/3.0, Seedance 1.5 Pro/2.0, Hailuo, Wan 2.7, HappyHorse, Gemini Omni), аудио (Suno, ElevenLabs), чатов (ChatGPT, Gemini, Claude). Также поддерживается загрузка референсов для нейросетей.

Базовый URL

https://api.aihere.ru/api/v1

Интерактивная документация Swagger

Быстрый старт

  1. Получите API-ключ в кабинете разработчика на aihere.ru и пополните баланс.
  2. Проверьте баланс:
bash
curl "https://api.aihere.ru/api/v1/balance" \
  -H "Authorization: Bearer $AIHERE_API_KEY"
  1. Поставьте задачу генерации:
bash
curl -X POST "https://api.aihere.ru/api/v1/images/seedream-t2i" \
  -H "Authorization: Bearer $AIHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Акварельный пейзаж горного озера на рассвете", "aspect_ratio": "4:3"}'
# → {"task_id": 123}
  1. Заберите результат поллингом (GET /task/{task_id}) или callback'ом (заголовок X-Callback-Url при создании).

Асинхронная модель

Все генерации асинхронны. Эндпоинт создания возвращает {"task_id": 123} — задача выполняется у провайдера, затем результат автоматически переносится в постоянное хранилище. Готовые ссылки приходят в result_urls статуса задачи или в callback-уведомлении. Стоимость списывается при постановке задачи; при сбое провайдера средства возвращаются автоматически.