菜单
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.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/QianJinGuo/wiki --skill agnes-ai命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| 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"}} |
Unified access to Sapiens AI's multimodal models via the Agnes AI platform. All models share a single API key.
| 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 |
https://apihub.agnes-ai.com/v1Authorization: Bearer $AGNES_IMAGE_API_KEYexport 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.
See references/ for session-specific detail from skill creation/debugging:
style param not supported
→ Reference: references/api-probing-results.mdextra_body pattern
→ Reference: references/api-probing-results.mdreferences/live-probe-2026-06-02.mdreferences/hand-drawn-marker-style.mdcurl -X POST https://apihub.agnes-ai.com/v1/images/generations \
-H "Authorization: Bearer $AGNES_IMAGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"agnes-image-2.0-flash","prompt":"a cat","size":"1024x1024"}'
# → Returns immediately with URL in data[].url
# Step 1: Submit
TASK_ID=$(curl -s -X POST https://apihub.agnes-ai.com/v1/videos \
-H "Authorization: Bearer $AGNES_IMAGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"agnes-video-v2.0","prompt":"a cat walking"}' \
| python3 -c "import sys,json; print(json.load(sys.stdin)['task_id'])")
# Step 2: Poll until completed
curl -s "https://apihub.agnes-ai.com/v1/videos/${TASK_ID}" \
-H "Authorization: Bearer $AGNES_IMAGE_API_KEY"
# → Completed response: remixed_from_video_id = MP4 URL
style param not supported on images — Causes 400 UnsupportedParamsError. Do not send it.n parameter ignored on images — Even n: 2 returns only 1 image.b64_json always null — Both image and video APIs only return URLs, never base64.queued task_id, must poll GET /videos/{id}.remixed_from_video_id — Not data[] like images. This field holds the MP4 URL.extra_body — Image arrays go inside extra_body.image, not at top level. Keyframes mode requires ≥2 images.style parameter name collision — Different from OpenAI's style param which this API rejects. Confusing but important.width+height.num_frames/frame_rate.agnes-image-2.0-flash not agnes-image-2. agnes-video-v2.0 not agnes-video-v2.GET /v1/models/agnes-image-2.0-flash returns "model does not exist". Use GET /v1/models to list.revised_prompt always null — No prompt auto-refinement on images or video.POST /v1/chat/completions returns 500 division by zero and POST /v1/videos returns 500 fail_to_fetch_task ("Authentication Error, Client is not connected to the query engine"). These are upstream backend bugs, not auth/credential problems. Image endpoints (/v1/images/generations) are stable. If chat/video is critical, retry once and fall back to image-2.1 for text-adjacent work, or treat the skill as image-only until upstream recovers.GET /v1/models lists 5 models — agnes-1.5-flash, agnes-2.0-flash, agnes-image-2.0-flash, agnes-image-2.1-flash, agnes-video-v2.0. The agnes-1.5-flash text model is undocumented by the platform but is a valid model ID.agnes-image-2.0-flash: a "system architecture diagram" prompt with labeled nodes produced structurally correct composition but garbled text labels (Atlsse and Hedrorct for "AWS and Bedrock", entiriss/concepts/comparisons for entities/concepts/comparisons, agent-nemss-architecture, imlf-systems, self-provemag). Short words ("mcp", "rag", "vibe-coding") and brand-style strings ("harness-engineering", "Multi-Agent") often survive. Use cases that need correct text (labeled diagrams, infographics, flow charts with readable node names, anything where labels carry the message) → use a structured diagram tool instead: Mermaid (markdown-native, edits inline), Excalidraw (hand-drawn JSON), or hand-rendered SVG/ASCII. Agnes / diffusion image models are only safe for: hero/cover images, mood imagery, decorative illustrations, and structural compositions where label legibility is non-critical. The right-tool-for-right-job pattern: generate a visual mood/cover image with Agnes for emotional appeal, then ship a Mermaid/Excalidraw/SVG version for the labeled/structural content that the user will actually read. Do not promise a "diagram" from a diffusion model and call it done.references/hand-drawn-marker-style.md for the prompt recipe + dual-track pattern. Do NOT improvise — the reference has the magic style words, palette cheat sheet, and a known-good template prompt. Without the reference, you'll get generic "clean infographic" output and waste 2-3 regenerations.references/hand-drawn-marker-style.md § "dual-track pattern (USER-VALIDATED)" for the full pattern.source ~/.zshenv # key lives here on macOS, not in ~/.hermes/.env
KEY=${AGNES_IMAGE_API_KEY:?must be set}
# 1. Confirm base URL reachable + auth works
curl -s -w "\nHTTP %{http_code}\n" "https://apihub.agnes-ai.com/v1/models" \
-H "Authorization: Bearer $KEY" | head -20
# Expect: HTTP 200, JSON `data` array with 5 model IDs
# 2. Confirm image endpoint is healthy (the stable path)
curl -s -X POST "https://apihub.agnes-ai.com/v1/images/generations" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"model":"agnes-image-2.0-flash","prompt":"a tiny red apple","size":"512x512"}' \
| python3 -c "import sys,json; d=json.load(sys.stdin); print('OK' if d.get('data',[{}])[0].get('url') else d)"
# Expect: OK (or HTTP 200 with a GCS URL)
# 3. Probe chat endpoint — currently 500 upstream
curl -s --max-time 10 -X POST "https://apihub.agnes-ai.com/v1/chat/completions" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"model":"agnes-2.0-flash","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'
# If HTTP 500 "division by zero" → text path down, use image-only
If the image probe fails: stop and treat the key as broken — do not retry indefinitely. The platform has no SLA on these endpoints.
| Feature | Image 2.0 | Video V2.0 |
|---|---|---|
| Sync/Async | Sync | Async (poll) |
| Response field | data[].url | remixed_from_video_id |
| Input image | input_image (string) or image_urls (array) | image (string) or extra_body.image (array) |
| Multi-image | image_urls: [...] | extra_body: {image: [...]} |
| Style param | ❌ rejected | N/A |
| Size | 1024x1024 default | 1280x768 default |
| Negative prompt | ✅ | ✅ |
| Seed | ✅ | ✅ |
基于 SOC 职业分类