Zui近不少朋友在问Agnes AI的免费API怎么接入，说实话，挺简单的。

一、Agnes AI免费API简介

Agnes AI提供了文本、图像、视频生成的API，而且是长期免费开放的，哈哈，这点就hen良心。

核心模型无过期限制，不绑卡、不充值也Neng用，一个Key、一个base_url就Neng跑通三类Neng力，你懂的，省事。

第一步：注册获取API Key

访问platform.agnes-ai.com，邮箱或Google/GitHub注册就行。

控制台路径：Settings → API Keys → Create new secret key

官方明确：免费用户Ke以直接跳过充值。

一句话：注册拿Key就Neng免费用，不用先掏钱。

第二步：了解API基本信息

所有请求须在请求头携带：

Authorization: Bearer YOUR_API_KEY

Key属于敏感信息，只用环境变量管理，别提交进Git，咱就是说安全第一嘛。

二、接入指南

Python——API 完全兼容OpenAI风格接口，改base_url即可：

import os
from openai import OpenAI
client = OpenAI(
    api_key=os.environ,
    base_url=os.environ,
)
resp = client.chat.completions.create(
    model="agnes--flash",
    messages=,
)
print

官方curl示例：

curl https://apihub.agnes-ai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes--flash",
    "messages": 
  }'

第三步：选择模型和配置参数

完整模型列表以控制台Models页面为准。

Hermes、Aider等终端Agent填OPENAI_API_KEY+base_url+model三项即可。

三、免费文本生成实例

from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
    model="agnes--flash",
    openai_api_key=os.environ,
    openai_api_base=os.environ,
)

是社区开源的CLI供应商管理工具，一键切换Claude Code、Codex、Gemini CLI等工具的API配置。用它把Claude Code的请求经本地路由转发到Agnes API Gateway，底层实际调用agnes--flash，全程免费。

四、为什么百度不收录我的文章？🤔

有人问，为什么百度不收录我的文章？ 害，这个问题嘛，老生常谈了。 一般来说要么是内容不够优质，要么是网站结构有问题，或者是抓取权限没设置好。 你先检查下robots.txt是不是屏蔽了百度蜘蛛🤖️。 对了还有个原因可Neng是你的网站权重太低😂。

检查下是不是原创内容，Ru果不是那人家凭啥收录你呢？ 再不行，Ke以试试提交sitemap，或者主动推送链接给百度，快的话当天就Neng收录哦！😉

继续说回Agnes AI。

文生图与图生视频示例

文生图——比如生成「小猫在足球场上踢足球」：

img = client.images.generate(
    model="agnes-image--flash",
    prompt="一只可爱的小猫在绿茵足球场上踢足球，阳光明媚，动感瞬间，高清摄影风格",
    size="1024x1024",
)
print

图改图——先拿上文文生图返回的小猫踢球图片URL，再传入extra_body.image Zuo二次编辑。指令写清「保留什么、改什么」：

# 上文文生图Yi得到原图URL
original_url = img.data.url
# 基于原图编辑：保留小猫踢球动作，改场景
edit = client.images.generate(
    model ="agnes-image--flash",
    prompt ="保留小猫踢足球的动作和足球不变，把场景改成傍晚的专业足球场，kan台有观众，球场灯光亮起，电影感",
    size ="1024x1024",
    extra_body ={
        "image": 
    },
)
print

同一原图还Ke以试不同改法，你懂的。

图生视频——拿上文图改图得到的小猫踢球静态图，继续生成动态短片；音画同步，无需后期配音。

import time
# 创建图生视频任务
task = client.post(
     "/videos",
     body ={
        "model": "agnes-video-v2.",
         "prompt": "一只可爱的小猫在傍晚的专业足球场上踢球，kan台有观众，球场灯光亮起，电影感 ",
         "image": edit.data.url,
         "num_frames": ,
         "frame_rate": ,
         "height": ,
         "width": ,
     },
     cast_to =object,
 )
task_id = task
# 轮询直到完成 
while True:
     result = client.get
     if result ==  "completed":
         print   # 视频URL 
         break
     time.sleep
 

硬约束： numframes 必须是8n+ 。视频走/v1/videos 端点 ， 异步任务 ，创建后轮询 GET /v1/videos/{taskid} 取结果。

五 、 免费接入Claude Code / Cursor / Agent

任何支持自定义Base URL的工具douNeng免费用。 其中Claude Code + CC-Switch 是官方文档重点推荐的接入方式 ， 配置完成后在Claude Code交互框架里直接走Agnes免费模型。

模型映射：

Sonnet   →   agnes--flash
Opus     →   agnes--flash 
Haiku    →   agnes--flash 

自定义参数：

{
   "allowed_openai_params": ,
   litellm_settings: {
     drop_params: true 
   }
}
 

启用后 ， Claude Code的请求经CC-Switch转发到Agnes API Gateway，用免费文本模型完成本地Agent和编码任务。

免费的文本模型agnes--flash 在Claw-Eval 中表现不俗 ：

说白了就是Neng省不少事儿😄。

---