Agnes AI Generation 技能用于通过统一接口调用 Agnes 文本、图像与视频生成 API，入口地址为 https://apihub.agnes-ai.com。使用时需在环境变量 AGNES_API_KEY、AGNES_API_TOKEN 或 APIHUB_AGNES_API_KEY 中提供 API 密钥，且不得打印密钥。需要端点细节、参数或响应字段时，可查阅 references/api.md；实际调用建议使用 scripts/agnes_api.py，而非手写 curl。
主要能力
- 文本生成与流式文本生成。
- 文生图、图生图，以及高信息密度图像生成。
- 文生视频、图生视频、多图视频、关键帧动画、基于提示的运动与场景控制、电影感输出。
- 视频任务为异步创建，可通过 video_id 轮询或检索结果。
- 支持基于种子的可复现性。
- 提供 smoke-test 轻量在线验证，默认不创建视频；可通过 --include-image-edit 加入图生图，通过 --video-case <case> 明确启用视频模式。
使用方式 文本生成：python scripts/agnes_api.py text --prompt "..." 流式文本：python scripts/agnes_api.py text --prompt "..." --stream 图像生成：python scripts/agnes_api.py image --prompt "..." --size 1024x768 图生图：python scripts/agnes_api.py image --prompt "..." --image https://example.com/input.png --size 1024x768 文生视频并轮询：python scripts/agnes_api.py video --prompt "..." --poll 图生视频：python scripts/agnes_api.py video --prompt "..." --image https://example.com/image.png --poll 关键帧/多图视频：python scripts/agnes_api.py video --prompt "..." --image https://example.com/a.png --image https://example.com/b.png --mode keyframes --poll 检索视频任务：python scripts/agnes_api.py video-get video_123456 轻量在线冒烟测试：python scripts/agnes_api.py smoke-test 图生图冒烟测试：python scripts/agnes_api.py smoke-test --include-image-edit 单视频冒烟测试：python scripts/agnes_api.py smoke-test --video-case text-to-video
工作流与限制 文本聊天/补全优先使用 agnes-2.0-flash。图像生成优先使用 agnes-image-2.1-flash，高密度生成由提示驱动，建议包含主体层级、环境、次要细节、光照、构图和质量要求。视频生成优先使用 agnes-video-v2.0。图像和视频生成前，应将非英文用户提示转换为流畅英文生成提示，并保留具体视觉细节、风格、光照、构图、运动、相机指令与约束。视频 API 为异步：先创建任务，再按 video_id 轮询或检索；仅当创建响应缺少 video_id 时脚本才回退到旧版 task_id 查询。脚本会在发送请求前校验图像尺寸、视频帧数、帧率和分辨率：num_frames 必须为 8n + 1 且不超过 441，81 或 121 是推荐的短值。video 命令默认 num_frames=121、frame_rate=24；视频冒烟测试默认 num_frames=81、frame_rate=24。视频能力测试应逐个运行 smoke-test --video-case <case>，支持 text-to-video、image-to-video、multi-image、keyframes。对于成本较高或耗时较长的在线视频生成，除非用户明确要求测试或生成视频，否则应先提醒用户。
输出处理 默认直接返回生成的图像/视频 URL，不下载、保存、打开或检查生成的媒体，除非用户明确要求本地文件或视觉检查。图像响应在 extra_body.response_format 为 url 时，预期返回 URL 形式结果。视频响应在 status 为 completed 时，从 video_url、url 或 remixed_from_video_id 中提取 URL。视频检索优先使用 GET /agnesapi?video_id=...&model_name=agnes-video-v2.0，旧版 GET /v1/videos/{task_id} 作为回退。请求失败时，应报告 HTTP 状态和提供方错误正文，但不得暴露 API 密钥。
验证状态与注意事项 已本地确认：技能元数据校验和 Python 语法。已通过在线 API 确认：基础文本、流式文本、工具调用请求形态、文生图、图生图、高信息密度文生图、图像/视频中文提示翻译、已完成的文生视频 URL 检索、已完成的图生视频 URL 检索。注意事项：Agnes 可能接受工具调用请求参数但不稳定返回 tool_calls，如需严格工具调用校验可使用 smoke-test --strict-tools；Agnes Responses API 多轮函数调用对智能体工具循环不可靠，不应依赖其实现 Codex/Claude 风格的自动工具续跑；多图视频和关键帧动画由脚本与 smoke-test 选择器支持，但最新一轮未完整端到端复跑；多图视频与关键帧动画的每个任务是否都能完成 URL 检索尚未端到端确认；此前一个文生视频任务曾返回提供方除零错误，因此视频重试应保持可见并清晰报告提供方错误。只有在基础文本、流式文本、工具调用、文生图、图生图、文生视频、图生视频、多图视频、关键帧视频和视频检索均成功返回时，才可将该技能视为完整测试通过。