Agnes API 全面测评哪些接口真正能用实测告诉你答案AI 探索笔记 · 实测日期2026 年 7 月最近 Agnes AI 的 API 服务经历了一次重大调整——域名切换、模型更迭、部分接口停服。到底现在哪些 API 能正常使用文生图质量如何视频接口为何被禁本文基于真实调用测试逐一拆解每个接口的状态并附上可落地的应用方案。一、域名迁移从 .com 到 .cnAgnes API 的请求地址已从https://apihub.agnes-ai.com/v1切换至https://apihub.agnes-ai.cn/v1。经实测两个域名目前都能正常访问但 .cn 域名有一个显著优势新增了agnes-2.5-flash模型而 .com 域名的模型列表中暂未出现该模型。这意味着 .cn 是目前更推荐使用的节点。两个域名均通过 Cloudflare CDN 加速实测延迟差异不大。建议开发者在代码中统一切换到 .cn 域名以获取最新的模型支持。二、模型全家福6 款模型一览当前 .cn 节点共注册了 6 款模型涵盖文本对话、图像生成和视频生成三大类模型名称类型实测状态agnes-2.0-flash文本对话✅ 可用agnes-2.5-flash文本对话✅ 可用仅.cnagnes-2.5-pro-alpha文本对话✅ 可用agnes-image-2.0-flash文生图✅ 可用agnes-image-2.1-flash文生图✅ 可用推荐agnes-video-v2.0文生视频❌ 403 禁用三、接口实测逐一拆解1. 文本对话接口/v1/chat/completionsPOST /v1/chat/completions Model: agnes-2.5-flash Input: hello Response: Hello! Im Agnes-2.5-Flash, developed by Sapiens AI. Status: 200 ✅文本对话接口运行稳定响应速度快实测 30 秒内返回结果。支持三个模型版本2.0-flash基础版、2.5-flash新版推荐和 2.5-pro-alpha高级版。适用场景包括智能客服、内容创作辅助、代码生成、知识问答、多轮对话应用等。接口完全兼容 OpenAI 格式迁移成本极低。2. 文生图接口/v1/images/generationsPOST /v1/images/generations Model: agnes-image-2.1-flash Size: 768×1152竖屏9:16 Response: 返回图片URL Status: 200 ✅ 生成耗时: 15-30秒/张文生图是目前最稳定、最实用的接口也是本文测试中最推荐的模型。agnes-image-2.1-flash生成的图片质量优秀支持多种尺寸1024×1024、768×1152、1152×768 等画面细节丰富、色彩还原准确。我们用它制作了一系列竖屏短视频包括《贝加尔湖的深渊密码》《武夷山悬棺》等未解之谜系列8 张场景图并行生成单张耗时 15-30 秒成功率接近 100%。3. 图生图接口/v1/images/edits⚠️ 状态503 Service Unavailable错误信息no available server —— 后端推理节点未部署图生图接口虽然已注册路由但后端推理服务当前处于不可用状态。实测使用小文件292 字节和大文件1.6MB 图片均返回 503 错误排除了 Cloudflare 上传限制的可能确认是服务端本身的问题。该接口的缺失意味着目前无法实现图片风格迁移、细节修改、局部重绘等高级图像编辑功能期待后续版本能够恢复。4. 文生视频接口/v1/video/generations❌ 状态403 Forbidden错误信息Model is blocked —— 模型已被封禁视频生成接口agnes-video-v2.0已被后端封禁调用时返回 403 错误。该接口之前支持 keyframes 模式生成短视频但目前完全不可用。封禁原因未公开可能是出于成本控制或服务稳定性考虑。替代方案文生图 TTS 语音合成 FFmpeg 视频拼接。虽然画面是静态的但配合高质量 AI 图片和语音旁白最终效果在短视频平台上依然有不错的表现。四、实战应用用现有 API 打造短视频生产线虽然视频接口不可用但我们用文生图 edge-tts Pillow FFmpeg 搭建了一套完整的短视频生产流水线 技术栈场景图生成agnes-image-2.1-flash支持 768×1152 竖屏 9:16语音旁白edge-tts微软免费 TTS 引擎中文发音自然标题叠加Pillow 库半透明黑色底条 白色大字视频合成FFmpeg静态图 音频 → H.264 视频片段 → concat 合并 生产效率8 张场景图并行生成约 60-90 秒TTS 语音合成约 20 秒标题叠加约 5 秒视频片段编码 合并约 3-5 分钟总计一支 8 场景竖屏短视频从零到成品约 5 分钟 关键经验并行生成图片接口支持并发4 线程并行可将 8 张图的总耗时缩短至 60 秒内错误重试API 偶发 429限流和 503 错误建议加入指数退避重试机制edge-tts 参数语速调节必须用--rate-5%格式等号连接用空格会报错FFmpeg 编码concat 合并时避免 stream copy建议统一 re-encode-c:v libx264 -preset fast -crf 23竖屏输出请求 768×1152实际返回 832×1248注意尺寸差异对字幕布局的影响五、API 调用代码示例importrequests API_KEYyour-api-keyAPIhttps://apihub.agnes-ai.cn/v1headers{Authorization:fBearer{API_KEY},Content-Type:application/json}# 1. 文本对话rrequests.post(f{API}/chat/completions,headersheaders,json{model:agnes-2.5-flash,messages:[{role:user,content:你好}],max_tokens:100})print(r.json()[choices][0][message][content])# 2. 文生图rrequests.post(f{API}/images/generations,headersheaders,json{model:agnes-image-2.1-flash,prompt:cinematic sunset,n:1,size:768x1152})urlr.json()[data][0][url]imgrequests.get(url).content六、总结与建议✅ 当前推荐使用agnes-2.5-flash文本对话速度快、质量好、仅 .cn 可用agnes-image-2.1-flash文生图最稳定的图像生成模型强烈推荐agnes-2.5-pro-alpha文本对话高级版适合对质量要求更高的场景⏳ 暂时不可用agnes-video-v2.0文生视频403 封禁可用图片 TTS 方案替代/v1/images/edits图生图503 无服务期待后续恢复 开发建议统一使用 .cn 域名获取最新模型支持所有接口兼容 OpenAI 格式可直接用 openai SDK 或 requests 调用加入 429/503 自动重试机制建议间隔 10-30 秒文生图支持并发善用多线程可大幅提升生产效率关注“GC随笔” 获取更多AI前沿知识