技能介绍

解决什么问题

集成 Agnes AI 的模型时，开发者常会在几个易错点上反复试错：图像接口的 response_format 放错层级直接返回 400，图生图输入图放错字段拿不到结果，视频任务用 task_id 轮询会排队五分钟以上，num_frames 不满足 8n + 1 直接失败。这个技能把官方文档中三大模型的调用细节整理成可直接参考的说明，让 Agent 一次调对。

覆盖的能力

文本对话 agnes-2.5-flash：OpenAI 兼容的 Chat Completions 接口，512K 上下文、65.5K 最大输出；支持流式输出、工具调用、图像 URL 输入，以及两种 Thinking 模式（chat_template_kwargs 与 thinking）。
图像生成 agnes-image-2.1-flash：文生图与图生图，size 支持 1K–4K 档位配合 ratio，也可传精确尺寸；输出 URL 或 Base64。
视频生成 agnes-video-v2.0：异步任务，先 POST /v1/videos 创建，再用 video_id 轮询结果；支持文生视频、图生视频（ti2vid）与关键帧动画（keyframes）。

关键步骤与注意点

鉴权统一使用 Authorization: Bearer <Key>，Key 在 platform.agnes-ai.com 创建且只显示一次，不要写入前端或公开仓库。
网关默认为 api.agnes-ai.cn，旧集成使用 apihub.agnes-ai.com 时只需替换主机名，路径与参数不变。
图像：response_format 必须放在 extra_body 内；图生图输入放 extra_body.image，不需要传 tags: ["img2img"]；尺寸须为 16 的倍数。
视频：num_frames ≤ 441 且满足 8n + 1，时长建议不超过 15 秒；只有 status: "completed" 时 metadata.url 才有可用地址。
限流：文本 RPM 20、视频 RPM 1，遇到 503/429 建议指数退避（1s→2s→4s→8s）。