agnes-ai

name	agnes-ai
description	Access Sapiens AI's multimodal models (Agnes AI platform) via OpenAI-compatible API. Covers agnes-2.0-flash (text), agnes-image-2.0-flash (image generation/editing), agnes-video-v2.0 (video generation), and agnes-image-2.1-flash.
version	1.0.0
author	["hermes"]
license	MIT
platforms	["macos","linux","windows"]
compatibility	Requires AGNES_IMAGE_API_KEY env var set to your API key from https://agnes-ai.com. This single key works for ALL model types (text, image, video). On macOS the key is typically exported from ~/.zshenv — it is NOT in ~/.hermes/.env.
prerequisites	{"commands":["curl"]}
metadata	{"hermes":{"tags":["image-generation","video-generation","agnes","openai-compat","creative","generative-ai","multimodal"],"category":"creative"}}

Agnes AI (Sapiens AI)

Unified access to Sapiens AI's multimodal models via the Agnes AI platform. All models share a single API key.

Quick Reference

Model	Type	Model ID	Endpoint
Agnes 2.0 Flash	Text	agnes-2.0-flash	POST /v1/chat/completions
Agnes Image 2.0 Flash	Image	agnes-image-2.0-flash	POST /v1/images/generations
Agnes Image 2.1 Flash	Image	agnes-image-2.1-flash	POST /v1/images/generations
Agnes Video V2.0	Video	agnes-video-v2.0	POST /v1/videos

• Base URL: https://apihub.agnes-ai.com/v1
• Auth: Authorization: Bearer $AGNES_IMAGE_API_KEY
• Docs: https://agnes-ai.com/doc/overview

Authentication

export AGNES_IMAGE_API_KEY="sk-YourApiKeyHere"

One key for everything — a single API key authenticates all model types (text, image, video). No separate key needed per modality.

Skills in this Umbrella

See references/ for session-specific detail from skill creation/debugging:

• Image generation: Text-to-image, img2img, multi-image compositing, size params, style param not supported → Reference: references/api-probing-results.md
• Video generation: Text-to-video, img2video, keyframe mode, async poll workflow, extra_body pattern → Reference: references/api-probing-results.md
• Text model: Standard OpenAI-compatible chat completions
• Live API verification transcript (2026-06-02): which endpoints are stable vs broken right now → Reference: references/live-probe-2026-06-02.md