AgnesAI-Models README

The project's README from github.com/AgnesAI-Labs/AgnesAI-Models. As one markdown file: README.md.

Agnes AI

English 简体中文 Error Codes | 常见错误码

Official gateway and model catalog for Agnes AI.

Agnes AI gives developers OpenAI-compatible access to multimodal models for text, image, video, and agent workflows through a unified API gateway.

About Agnes AI

Agnes AI is a frontier AI company focused on full-modality foundation models. We train models in-house across text, image, video, and reasoning. Our mission is to make high-quality AI more accessible, scalable, and easy to plug into any product or platform.

Our model suite features high-precision models ranked on PinchBench and is purpose-built to power agentic tools such as OpenClaw and Hermes. Alongside text-to-image, image-to-image, and image-to-video models, it delivers cinematic-quality visuals, synchronized audio-visual generation, and fast performance for seamless creation, transformation, and deployment of rich AI-generated content.

Documentation Status

Field Value
Public documentation version 2026.07.30
Last updated 2026-07-30 00:00 Asia/Singapore
Source of truth Official website and API platform
Change notice Model availability, rate limits, pricing, and quota rules may change over time. Always confirm production-critical values in the official docs or platform console.
Resource URL
International site https://agnes-ai.com/
China site https://agnes-ai.cn/
Developer Docs https://agnes-ai.com/doc/overview
API Platform https://platform.agnes-ai.com/
API Base URL https://apihub.agnes-ai.com/v1

Agnes AI provides two official sites: the International site and the China site. Choose the site that matches your region and service needs.

Developer Resources

Resource Purpose
MODEL_CATALOG.md Model families, endpoints, current reference limits, and compatibility notes.
CHANGELOG.md Public documentation, model, quota, and integration updates.
SUPPORT.md Where to ask for help, what belongs in issues, and what belongs in discussions.
docs/TROUBLESHOOTING.md API error codes, debugging checklist, and retry guidance.
docs/ERROR_CODES.md Bilingual common API status codes, causes, and recommended fixes.
docs/FAQ.md Common questions about access, limits, models, and video polling.
docs/TOKEN_PLAN_FAQ.md Token Plan access types, RPM limits, subscription quotas, and API key limit pools.
docs/DISCUSSIONS.md Recommended discussion categories and community workflow.
examples/ Minimal curl, Python, and Node.js examples.

Models

Model Type Endpoint Highlights
agnes-2.5-flash Text and vision-language /v1/chat/completions Upgraded coding, agent workflows, tool calling, multi-turn dialogue, reasoning, and image understanding
agnes-2.0-flash Text and vision-language /v1/chat/completions Reasoning, coding, tool calling, streaming, image understanding, agent workflows
agnes-image-2.0-flash Image generation and editing /v1/images/generations Text-to-image, image-to-image, URL or Base64 output
agnes-image-2.1-flash Image generation and editing /v1/images/generations High-density visual generation, image editing, flexible sizes, URL or Base64 output
agnes-video-v2.0 Video generation /v1/videos Text-to-video, image-to-video, multi-image video, keyframe animation, async task API

Python Quick Start

Install the example dependencies:

pip install -r requirements.txt
export AGNES_API_KEY="your_api_key_here"

Run a streaming chat completion:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_AGNES_API_KEY",
    base_url="https://apihub.agnes-ai.com/v1",
)

response = client.chat.completions.create(
    model="agnes-2.5-flash",
    messages=[
        {"role": "user", "content": "Write a short intro to Agnes AI."}
    ],
    stream=True,
)

for chunk in response:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="")

Python examples:

Example Purpose
examples/python/chat.py Streaming chat completion with agnes-2.5-flash.
examples/python/openai_compatible.py Minimal OpenAI-compatible client configuration.
examples/python/image_generation.py Text-to-image request with agnes-image-2.1-flash.
examples/python/video_generation.py Text-to-video task creation and video_id polling.
examples/python/agent_workflow.py Tool-calling style agent workflow example.

Current Access and Limits

The values below are current public reference values as of 2026-06-28. Base Token Plan quotas were published on 2026-06-22; video RPM limits were updated on 2026-06-28. These are operational limits, not permanent guarantees.

User Plans

User plan Text model RPM Image model RPM Video model RPM and quota
Free / default 20 actual RPM Resolution-specific RPM limits apply 1 actual RPM
Enterprise 40 actual RPM Higher resolution-specific RPM limits apply 2 actual RPM
Token Plan 1,000 actual RPM for text models Higher 1K and 2K image RPM limits apply 5 actual RPM; 500 seconds per day

Subscription Quotas

Plan agnes-2.0-flash agnes-image-2.0/2.1-flash agnes-video-v2.0
Starter 1,500 requests per 5 hours; 15,000 requests per week 4,000 images per day 500 seconds per day
Plus 7,500 requests per 5 hours; 75,000 requests per week 4,000 images per day 500 seconds per day
Pro 30,000 requests per 5 hours; 300,000 requests per week 4,000 images per day 500 seconds per day

For detailed per-model RPM tables, quota rules, and API key pool behavior, see MODEL_CATALOG.md and docs/TOKEN_PLAN_FAQ.md.

Chat Example

curl https://apihub.agnes-ai.com/v1/chat/completions \
  -H "Authorization: Bearer $AGNES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-2.0-flash",
    "messages": [
      {
        "role": "user",
        "content": "Explain how to integrate an OpenAI-compatible API gateway."
      }
    ],
    "stream": true
  }'

Image Example

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer $AGNES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "A luminous floating city above a misty canyon at sunrise, cinematic realism",
    "size": "1024x768"
  }'

Video Example

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": "A cinematic shot of a cat walking on the beach at sunset, soft ocean waves, warm golden lighting, realistic motion",
    "height": 768,
    "width": 1152,
    "num_frames": 121,
    "frame_rate": 24
  }'

Video generation is asynchronous. Create a task first, then query the result with the returned video_id.

GET https://apihub.agnes-ai.com/agnesapi?video_id=<VIDEO_ID>

Use video_id for video result polling. Do not use task_id for current video result queries unless a specific legacy workflow explicitly requires it.

Common Integration Notes

Security

Never commit API keys, tokens, .env files, screenshots containing secrets, or private data.

Use environment variables for local development:

export AGNES_API_KEY="your_api_key_here"

Documentation

See the official docs for model-specific parameters, response formats, pricing, limits, and troubleshooting:

AgnesAI-Models (AgnesAI-Labs/AgnesAI-Models)

Searching Database…

5.2K ·GitHub
AgnesAI-Models
What is this?Agnes AI is the official gateway and model catalog for Agnes AI, giving developers OpenAI-compatible access to multimodal models for text, image, video, and agent workflows through one unified API.
Is this a library I install, or a hosted API service?It is a hosted API service: you call the gateway's REST endpoints for chat, image, and video generation. This repository mainly provides documentation, the model catalog, and example client code rather than an installable package.
How do I start making requests to the models?Install the example dependencies and send a request with your API key; the repo ships ready-made curl, Python, and Node.js examples such as chat.py, imagegeneration.py, and videogeneration.py in examples/.
Do I need an API key before I can call any model?Yes, every request requires an Agnes API key sent as a bearer token, and it should be kept server-side rather than exposed in client code.
What happens if I hit the rate limit?Free-tier accounts get only 20 RPM for text models and 1 RPM for video, so 429 errors are common; the docs recommend adding retry with backoff and checking your plan's RPM limit.
What models are available in the catalog?It covers agnes-2.5-flash and agnes-2.0-flash for text and vision-language chat, agnes-image-2.0-flash and agnes-image-2.1-flash for image generation and editing, and agnes-video-v2.0 for text-to-video, image-to-video, and keyframe animation.
How does video generation work?Video generation is asynchronous: you create a task first, then poll the result using the returned videoid rather than the legacy taskid.
Can I reuse my existing OpenAI client code with this?Yes, agnes-2.5-flash and agnes-2.0-flash are OpenAI-compatible, keeping the same base URL, endpoint, request format, streaming, and tool-calling behavior as OpenAI's API.
Why are there separate International and China sites?Agnes AI runs two official sites so developers can pick the one matching their region and service needs, since availability can differ.
What are similar projects?CodeVideoModel, Toonflow-app, dramaclaw, printfilm, seedance-2.0-api, ComfyUI-ALLinONE-MinimaxH3, cookbook, gufo
Which topics is it in?free-api, multimodal-ai, image-to-video, api-gateway, text-to-video, text-to-image, saas, multimodal, video-generation, openai-compatible, image-generation, streaming
Creator
AgnesAI-Labs
Size
0.1 MB
Stars
5.2K
Updated
CommitAug 18
Age
5mo
Commits · 90 Days