# Agnes AI — бесплатный omni-modal API (текст + фото + видео одним ключом)

Статус: desk-research + live-проб эндпоинтов (2026-10-12). Регистрация и генерация НЕ тестированы — перед интеграцией прогнать smoke-тест.

## Что это
- agnes-ai.com / platform.agnes-ai.com — «Free Omni-Modal AI API»: text, image gen/edit, video gen одним Bearer-ключом.
- Заявлено (README jomeswang/agnes-ai-skill): free global calls, без фиксированной даты конца, RPM 20 на free.
- Пруф живости: platform.agnes-ai.com → 200; `GET https://apihub.agnes-ai.com/v1/models` без токена → 401 `{"error":{..."Token not provided"..."type":"AgnesAI_error"}}` — API отвечает.
- Регистрация: **Google OAuth** (`GoogleOAuthProvider` в исходнике platform-страницы) → фармится существующим Google/Gmail-пулом.

## API
- Base: `https://apihub.agnes-ai.com/v1` — НЕ `api.agnes-ai.com`. Auth: `Authorization: Bearer <AGNES_API_KEY>`.
- Модели: `agnes-2.0-flash` (text/chat/tool-calling), `agnes-image-2.0-flash` / `agnes-image-2.1-flash` (t2i/i2i/compose), `agnes-video-v2.0` (t2v/i2v/multi-image/keyframes).

### Видео-флоу (асинхронный)
```bash
# 1. Submit
curl -X POST https://apihub.agnes-ai.com/v1/videos \
  -H "Authorization: Bearer $AGNES_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"agnes-video-v2.0","prompt":"...","height":768,"width":1152,"num_frames":121,"frame_rate":24}'
# → {"task_id":"task_xxx","status":"queued"}
# 2. Poll (1–3 мин на ~5-сек клип)
curl https://apihub.agnes-ai.com/v1/videos/task_xxx -H "Authorization: Bearer $AGNES_API_KEY"
# → {"status":"completed", "remixed_from_video_id":"https://..."}
```

## Квирки (из готовых скиллов, не очевидны)
- URL готового видео лежит в поле **`remixed_from_video_id`** (кривой нейминг — не remix, а результат).
- Image-to-image: входные картинки класть в `extra_body.image` (массив), НЕ в top-level.
- `response_format` — только в `extra_body`, на top-level → 400.

## Готовый софт (брать, не писать)
- `jomeswang/agnes-ai-skill` — Agent Skill, заявлена совместимость с Hermes; установка `npx skills add jomeswang/agnes-ai-skill -g`.
- `1038lab/Agnes-AI` — zero-dependency Python CLI: `agnes text|image|video|poll|smoke-test|setup` — начинать проверку с smoke-test.
- `qiz7z/Agnes-picture-video-skill` — node driver.mjs; `ChenOneTo/agnes-video-gen` — минимальный SKILL.md с curl-флоу.

## Масштабирование (если free упрётся)
Платные тиры копеечные: Starter $2/мес = 1500 req/5h, Plus $5 = 7500, Pro $25 = 30000 req/5h.

## Риски и проверка перед постом/интеграцией
- В живых доках есть pricing-секции; «free» может быть промо-позиционированием (материалы от 01.06.2026). Перед тяжёлой интеграцией сверить billing-страницу платформы.
- linux.do тред 2726245: «短视频工厂» — фабрика коротких видео на Agnes Video (подтверждение массового бесплатного использования сообществом).
- Полный快照 разведa рынка фото/видео-генерации (Dreamina 225/день, Kling 66/день, Sora мертва, Ropewalk, apexapi, Protoface): `C:/Users/User/tmp/photo_video_abuse_research_2026-10-12.md`.