logo

Agnes实测:文本文生图可用,视频接口403

作者:很酷cat2026.11.17 03:39浏览量:0

简介:本文基于2026年7月的实测记录,整理Agnes API的域名切换、模型列表和接口状态。文本对话与文生图接口可正常调用,视频模型agnes-video-v2.0返回403,暂不适合接入生产。文中包含两套域名的差异、OpenAI兼容写法、文生图耗时与尺寸注意事项,以及视频接口的排查步骤,帮助开发者决定接入顺序。

先说结论

根据2026年7月的实测记录,Agnes API 的文本对话和文生图接口可以正常调用。视频生成模型 agnes-video-v2.0 返回 403,暂不建议直接接入生产环境。这份记录距今已有数月,接口状态可能已经变化,动手前应先用自己的 Key 重新测一遍。

一、域名与模型:先确认调用地址

近期 Agnes 的 API 服务做过一次调整,涉及域名切换、模型列表更新和部分接口状态变化。这些变化会直接影响调用地址、模型名称、鉴权方式和错误处理逻辑。

实测时,.com 和 .cn 两个域名都能访问,两者都经过 Cloudflare CDN 加速,延迟差异不大。区别在模型列表:.cn 域名已注册 agnes-2.5-flash,.com 域名的列表中暂未出现该模型。如果业务需要最新的文本模型,可以优先使用 .cn 域名。

切换域名时,只改 base_url 往往不够,还要检查以下内容:

  • API Key 是否与新域名绑定;
  • 模型名称是否仍被支持;
  • SDK 或 HTTP 客户端是否写死了旧地址;
  • 监控、日志和重试策略是否覆盖新域名;
  • 灰度阶段是否需要保留双域名 fallback。

二、接口状态总览

实测记录显示,.cn 节点注册了 6 个模型,分别覆盖文本对话、文生图和文生视频三类能力。

模型名称 类型 实测状态 建议
agnes-2.0-flash 文本对话 可用 作为基础对话模型
agnes-2.5-flash 文本对话 可用,仅 .cn 优先测试
agnes-2.5-pro-alpha 文本对话 可用 评估复杂任务
agnes-image-2.0-flash 文生图 可用 用于图像生成测试
agnes-image-2.1-flash 文生图 可用 生成质量与稳定性值得优先验证
agnes-video-v2.0 文生视频 返回 403 暂不建议生产接入

文本和图像能力已具备调用条件,视频能力目前不可用。团队应先跑通文本和图像链路,再判断视频能力是否为业务必需。如果必需,就等待官方开放或准备替代方案。

三、文本对话接口:兼容 OpenAI 格式

文本对话接口路径为 /v1/chat/completions。实测使用 agnes-2.5-flash,输入简单文本后返回状态码 200。原始记录称响应可在 30 秒内返回,但没有给出样本量和分位数耗时。因此,这个数字只能说明单次体验,不能当作稳定性能指标。

接口兼容 OpenAI 格式,熟悉 OpenAI SDK 的开发者迁移成本较低。运行下面的代码前,先安装依赖:

  1. pip install --upgrade openai
  1. import os
  2. from openai import OpenAI
  3. client = OpenAI(
  4. api_key=os.environ["AGNES_API_KEY"],
  5. base_url="https://api.agnes.cn/v1",
  6. )
  7. response = client.chat.completions.create(
  8. model="agnes-2.5-flash",
  9. messages=[{"role": "user", "content": "hello"}],
  10. )
  11. print(response.choices[0].message.content)

API Key 从环境变量读取,不要写进代码或日志。response.choices 是列表,所以要用 [0] 取第一条结果。

为了让输出更稳定,可以在应用层加入以下策略:

  1. 模型降级:agnes-2.5-flash 限流或超时时,切换到 agnes-2.0-flash。
  2. 超时控制:对话类请求设置 10 到 30 秒超时,避免连接长时间挂起。
  3. 有选择的重试:只对网络错误、超时和可恢复错误重试。鉴权失败不要盲目重试。
  4. 内容安全过滤:面向公众的场景,在输入和输出两侧都做审核。
  5. 日志追踪:记录模型名、请求 ID、耗时和错误码,方便排查。

这类接口适合智能客服、内容创作辅助、代码生成、知识问答和多轮对话。免费或低门槛接口通常有并发和速率限制,生产环境要提前设计兜底方案。

四、文生图接口:可用,但要注意耗时和尺寸

文生图接口路径为 /v1/images/generations。实测使用 agnes-image-2.1-flash,请求尺寸为 768x1152,接口返回图片 URL,状态码为 200。原始记录给出的耗时约为每张 15 到 30 秒。

示例代码如下:

  1. import os
  2. from openai import OpenAI
  3. client = OpenAI(
  4. api_key=os.environ["AGNES_API_KEY"],
  5. base_url="https://api.agnes.cn/v1",
  6. )
  7. response = client.images.generate(
  8. model="agnes-image-2.1-flash",
  9. prompt="a futuristic city at night, vertical poster, cinematic lighting",
  10. size="768x1152",
  11. )
  12. print(response.data[0].url)

这里要纠正一个换算问题。768x1152 的宽高比是 2:3,属于竖版,不是 9:16。如果需要严格的 9:16 竖屏,可以尝试 720x1280。不过,能否使用某个尺寸,要以官方文档或自己的实测结果为准。

接入文生图时还要注意三点:

  • 耗时较长:15 到 30 秒一张,不适合强实时交互,更适合异步任务。
  • URL 有效期:如果返回的是临时链

发表评论

活动