文章目录背景先说结论一、文本模型Agnes-2.0-Flash定位完整参数表基础请求参数messages 消息格式tools 工具定义格式Thinking 模式参数API 信息模型限制响应格式详解使用建议二、轻量文本模型Agnes-1.5-Flash定位完整参数表多模态消息格式文本图像API 信息模型限制与 2.0-Flash 的关键区别使用建议三、图像模型Agnes Image 2.1 Flash定位完整参数表文生图请求参数extra_body 参数图生图API 信息Prompt 结构详解图生图 Prompt 结构高信息密度图像技巧使用建议四、图像模型Agnes Image 2.0-Flash定位完整参数表关键参数说明API 信息响应格式与 2.1-Flash 的选择建议五、视频模型Agnes Video V2.0定位完整参数表创建视频任务参数num_frames 约束重要视频时长计算异步任务工作流任务状态说明错误码Prompt 结构详解参数推荐配置API 信息六、全模型参数速查对照公共参数各模型 Endpoint 汇总各模型价格汇总现价均为免费七、快速上手代码示例Python 文本调用Python 图像调用Python 视频调用异步八、总结背景周一的时候看到了一篇公众号推文所以就趁着这个机会去试了下。官网参考agnes-ai使用方式很简单注册一个账号然后获取api key其余和前面介绍的LLM使用方式一致。model方面的话暂时就下面这么5个我也一并按照前面介绍过的方式在claude code以及copilot oai中接入了可以参考我前面的博客。我试了一下几个任务还是挺不错的至少生成速度很快目前作为我的备用方案调整如下2.0 flash开thinking在oai的advanced settings中设置目前用于coding、agent任务主力1.5 flash没有thinking但是多模态作为简单的文本问答图片简单解析即问即答其余的model我暂时没有深度需求配置方式下图是copilot中调用还是参考我之前的博客Vscode LLM备用方案先说结论Agnes AI 将旗下全部核心模型 API无限期免费开放。不是试水某个模型而是文本、图像、视频三个模态一次性打包。本文按模型逐一拆解重点讲清楚每个参数什么意思、怎么设、什么场景用什么值。一、文本模型Agnes-2.0-Flash定位面向智能体工作流、工具调用、编程、推理的生产级语言模型。Claw-Eval 基准测试 General Leaderboard 排名第 9Pass^3 分数 60.9%。完整参数表基础请求参数参数类型必填说明推荐值modelstring✅模型名称固定为agnes-2.0-flashagnes-2.0-flashmessagesarray✅对话消息数组每个元素含role和content—temperaturenumber❌控制输出随机性。0完全确定1最大随机确定性任务 0.1-0.3创意任务 0.7-0.9top_pnumber❌核采样阈值。0.1只考虑高概率token1.0不限制默认 1.0需要稳定输出可设 0.9max_tokensnumber❌响应最多生成的 token 数根据任务设定一般 1024-4096streamboolean❌是否启用流式输出。true逐块返回false一次性返回实时交互场景用 truetoolsarray❌工具定义数组用于 function calling见下方工具定义格式tool_choicestring/object❌控制模型是否/如何使用工具。auto自动选择none不调用{type:function,function:{name:xxx}}强制调用某个工具auto为默认messages 消息格式{role:system|user|assistant,content:消息内容}system设定角色和行为准则放在消息数组最前面user用户输入assistant模型回复用于多轮对话上下文tools 工具定义格式{type:function,function:{name:get_weather,description:获取某地点的当前天气,parameters:{type:object,properties:{location:{type:string,description:城市和国家}},required:[location]}}}Thinking 模式参数针对编程、调试、推理、Agent 工作流开启深度思考可显著提升质量。OpenAI 兼容格式{model:agnes-2.0-flash,messages:[...],chat_template_kwargs:{enable_thinking:true}}Anthropic 兼容格式{model:agnes-2.0-flash,messages:[...],thinking:{type:enabled,budget_tokens:2048}}参数说明建议enable_thinking是否开启深度思考编程/推理任务设为truetype固定为enabled—budget_tokens最大思考 token 预算简单任务 2048复杂调试/多步骤 Agent 任务可提高到 4096-8192API 信息Endpoint: https://apihub.agnes-ai.com/v1/chat/completions Method: POST Content-Type: application/json Auth: Authorization: Bearer YOUR_API_KEY模型限制项目数值Context Window256KMax Output65.5K响应格式详解{id:chatcmpl_xxx,// 本次请求唯一 ID用于追踪object:chat.completion,// 对象类型created:1774432125,// 请求时间戳Unix 秒model:agnes-2.0-flash,// 使用的模型choices:[// 生成结果列表{index:0,// 结果索引多候选时有用message:{role:assistant,// 角色固定为 assistantcontent:模型生成的内容},finish_reason:stop// 停止原因stop正常结束lengthmax_tokens 触发tool_calls触发了工具调用}],usage:{prompt_tokens:35,// 输入 token 数completion_tokens:58,// 输出 token 数total_tokens:93// 总计}}使用建议Prompt 结构[角色] [任务] [上下文] [要求] [输出格式]temperature代码生成/调试用 0.1-0.3文案创作用 0.7-0.9stream需要实时反馈的场景如聊天机器人设为 trueThinking编程任务务必开启budget_tokens 从 2048 起步二、轻量文本模型Agnes-1.5-Flash定位低延迟、高并发、低成本场景的轻量模型。支持文本图像多模态输入。完整参数表参数类型必填说明推荐值modelstring✅固定为agnes-1.5-flash—messagesarray✅对话消息数组—temperaturenumber❌采样温度控制随机性0.5-0.8top_pnumber❌核采样概率默认 1.0max_tokensinteger❌最大生成 token 数根据任务设定frequency_penaltynumber❌频率惩罚减少重复内容。范围通常 -2.0~2.0正值降低重复0.0-0.5presence_penaltynumber❌存在惩罚鼓励引入新话题。范围通常 -2.0~2.00.0-0.5repetition_penaltynumber❌重复控制系数1.0-1.2stopstring/array❌自定义停止序列。遇到这些字符串就停止生成—seedinteger❌随机种子保证结果可复现固定值可复现多模态消息格式文本图像{role:user,content:[{type:text,text:描述这张图片},{type:image_url,image_url:{url:https://example.com/image.jpg}}]}type: text纯文本内容type: image_url图像 URL模型会理解图像内容并与文本联合响应API 信息Endpoint: https://apihub.agnes-ai.com/v1/chat/completions Method: POST Auth: Bearer Token模型限制项目数值Context Window256KMax Output65.5K与 2.0-Flash 的关键区别维度1.5-Flash2.0-Flash侧重速度、成本推理、Agent、编程多模态输入✅ 文本图像❌ 纯文本Thinking 模式❌✅工具调用❌✅frequency/presence_penalty✅ 支持❌ 不支持价格$ 0.07/ $0.15 per 1M tokens$ 0.1/ $0.2 per 1M tokens使用建议图像理解用content数组同时传入文本和图像 URL模型会联合理解高并发场景1.5-Flash 的量化技术降低了计算资源需求适合批量处理需要复现结果设置固定seed值三、图像模型Agnes Image 2.1 Flash定位升级版图像生成模型文生图 图生图重点优化了高信息密度图像的生成质量。完整参数表文生图请求参数参数类型必填说明推荐值modelstring✅固定为agnes-image-2.1-flash—promptstring✅图像生成的文本指令描述想要的内容越详细越好sizestring❌输出图像尺寸1024x768等extra_bodyobject❌高级工作流的额外参数见下方extra_body 参数图生图参数类型必填说明extra_body.imagearray图生图时✅输入图像 URL 数组图生图任务的源图像extra_body.response_formatstring❌响应格式url返回图像 URLAPI 信息Endpoint: https://apihub.agnes-ai.com/v1/images/generations Method: POST Auth: Bearer Token Price: $0/image免费Prompt 结构详解[主体] [场景/环境] [风格] [光照] [构图] [质量要求]组成部分说明示例主体画面的核心对象A luminous floating city场景/环境主体所处的环境above a misty canyon at sunrise风格艺术风格cinematic realism光照光线效果soft golden light构图画面布局wide-angle composition质量要求细节程度high visual density图生图 Prompt 结构[需要改变什么] [需要保持什么不变]示例Transform the scene into a rain-soaked cyberpunk night with neon reflections while preserving the original composition and main subject layout.高信息密度图像技巧2.1-Flash 针对复杂场景做了专项优化。Prompt 中需要清晰描述主体画面核心对象背景远景元素环境氛围、天气、时间重要细节关键视觉元素次要细节丰富画面层次风格与光照整体调性构图限制视角、比例使用建议文生图用详细 prompt包含所有 6 个组成部分图生图明确说明改什么和保什么高密度场景逐层描述视觉元素不要遗漏重要细节四、图像模型Agnes Image 2.0-Flash定位高性能图像编辑与生成模型支持图生图 多图合成。Artificial Analysis Image Editing Leaderboard ELO 1,184Top 20。完整参数表参数类型必填说明推荐值modelstring✅固定为agnes-image-2.0-flash—promptstring✅图像编辑/生成的文本提示词—sizestring❌输出图像尺寸1024x768、1024x1024、768x1024seednumber❌随机种子保证结果可复现固定值可复现tagsarray❌任务类型标记[img2img]表示图生图extra_body.imagearray图生图时✅输入图像 URL 数组—extra_body.response_formatstring❌输出格式url关键参数说明tags: [img2img]图生图任务必须添加此标记否则模型会当作文生图处理extra_body.image可传单张或多张图像 URL。多图时会将多张图合成为一张新图像seed设置固定值可复现相同结果适合需要迭代优化的场景API 信息Endpoint: https://apihub.agnes-ai.com/v1/images/generations Method: POST Auth: Bearer Token Price: $0/image免费响应格式{created:1774432125,data:[{url:https://...}],usage:{generated_images:1}}与 2.1-Flash 的选择建议需求选哪个从零生成复杂场景2.1-Flash高信息密度优化编辑现有图像2.0-Flash图生图专精多图合成2.0-Flash支持多参考图需要 seed 复现2.0-Flash支持 seed 参数五、视频模型Agnes Video V2.0定位下一代电影级视频生成模型支持文生视频、图生视频、多图视频、关键帧动画四种工作流。完整参数表创建视频任务参数参数类型必填说明推荐值modelstring✅固定为agnes-video-v2.0—promptstring✅视频内容的文本描述—imagestring/array❌输入图片 URL 或 URL 数组图生视频时必填modestring❌生成模式ti2vid文生视频或keyframes关键帧heightinteger❌视频高度768widthinteger❌视频宽度1152num_framesinteger❌视频总帧数见下方约束num_inference_stepsinteger❌推理步数默认值即可seedinteger❌随机种子保证可复现固定值可复现frame_ratenumber❌视频 FPS1-60推荐 24negative_promptstring❌负向提示词描述要避免的内容—extra_body.imagearray多图/关键帧时✅多图或关键帧的输入图片 URL—extra_body.modestring关键帧时✅额外模式设置keyframesnum_frames 约束重要num_frames 必须满足两个条件 1. num_frames ≤ 441 2. num_frames 8n 1n 为正整数 合法值81, 121, 161, 201, 241, 281, 321, 361, 401, 441 非法值100, 150, 200, 300 等视频时长计算seconds num_frames / frame_rate目标时长num_framesframe_rate实际时长约 3 秒81243.375s约 5 秒121245.042s约 6 秒161246.708s约 10 秒2412410.042s约 18 秒4412418.375s调整策略想要更长的视频 → 降低frame_rate如 12fps想要更流畅的画面 → 提高frame_rate如 30fps但时长会变短异步任务工作流视频生成是异步的分两步Step 1创建任务POST https://apihub.agnes-ai.com/v1/videos返回{id:task_xxx,task_id:task_xxx,object:video,model:agnes-video-v2.0,status:queued,// 任务状态progress:0,// 进度 0-100created_at:1780457477,// 创建时间戳seconds:10.0,// 预计时长size:1280x768// 分辨率}Step 2轮询结果GET https://apihub.agnes-ai.com/v1/videos/{task_id}返回完成时{id:task_xxx,model:agnes-video-v2.0,object:video,status:completed,// 任务状态progress:100,seconds:10.0,size:1280x768,error:null,remixed_from_video_id:https://storage.../video_xxxxxx.mp4// 视频 URL}任务状态说明状态说明下一步queued排队等待中继续轮询in_progress正在生成中继续轮询completed生成完成从remixed_from_video_id获取视频failed生成失败检查error字段调整参数重试错误码错误码说明处理400请求参数无效检查参数格式和约束401未授权检查 API Key404任务不存在检查 task_id500服务器错误稍后重试503服务繁忙稍后重试Prompt 结构详解文生视频[主体] [动作] [场景] [镜头运动] [光照] [风格]图生视频描述哪些内容需要运动同时保持关键主体稳定多图视频描述输入图片之间的关系和过渡方式关键帧动画清晰描述帧与帧之间的过渡关系参数推荐配置场景widthheightnum_framesframe_rate标准视频115276812124短视频社交115276881 或 12124更流畅运动115276812130可复现结果———设置固定 seed关键帧过渡———extra_body.mode: “keyframes”API 信息创建任务: POST https://apihub.agnes-ai.com/v1/videos 查询结果: GET https://apihub.agnes-ai.com/v1/videos/{task_id} Auth: Bearer Token Price: $0/second免费六、全模型参数速查对照公共参数参数2.0-Flash1.5-FlashImage 2.1Image 2.0Video V2.0model✅✅✅✅✅messages✅✅❌❌❌prompt❌❌✅✅✅temperature✅✅❌❌❌top_p✅✅❌❌❌max_tokens✅✅❌❌❌seed❌✅❌✅✅stream✅❌❌❌❌size❌❌✅✅❌image❌❌extra_bodyextra_body✅ / extra_bodytools✅❌❌❌❌thinking✅❌❌❌❌num_frames❌❌❌❌✅frame_rate❌❌❌❌✅negative_prompt❌❌❌❌✅各模型 Endpoint 汇总模型Endpoint文本2.0/1.5POST /v1/chat/completions图像2.1/2.0POST /v1/images/generations视频 V2.0POST /v1/videos→GET /v1/videos/{task_id}各模型价格汇总现价均为免费模型输入价格输出价格其他2.0-Flash$ 0.1/1M → $0$ 0.2/1M → $0—1.5-Flash$ 0.07/1M → $0$ 0.15/1M → $0—Image 2.1——$ 0.003/image → $0Image 2.0——$ 0.003/image → $0Video V2.0——$ 0.005/second → $0七、快速上手代码示例Python 文本调用importhttpx responsehttpx.post(https://apihub.agnes-ai.com/v1/chat/completions,headers{Authorization:Bearer YOUR_API_KEY},json{model:agnes-2.0-flash,messages:[{role:user,content:Hello}],temperature:0.7,max_tokens:1024,stream:False,})print(response.json()[choices][0][message][content])Python 图像调用responsehttpx.post(https://apihub.agnes-ai.com/v1/images/generations,headers{Authorization:Bearer YOUR_API_KEY},json{model:agnes-image-2.1-flash,prompt:A floating city above a misty canyon at sunrise,size:1024x768,})print(response.json()[data][0][url])Python 视频调用异步# Step 1: 创建任务create_resphttpx.post(https://apihub.agnes-ai.com/v1/videos,headers{Authorization:Bearer YOUR_API_KEY},json{model:agnes-video-v2.0,prompt:A cinematic shot of a cat walking on the beach at sunset,height:768,width:1152,num_frames:121,frame_rate:24,})task_idcreate_resp.json()[task_id]# Step 2: 轮询结果importtimewhileTrue:resulthttpx.get(fhttps://apihub.agnes-ai.com/v1/videos/{task_id},headers{Authorization:Bearer YOUR_API_KEY})dataresult.json()ifdata[status]completed:print(data[remixed_from_video_id])breakelifdata[status]failed:print(Failed:,data.get(error))breaktime.sleep(5)# 每 5 秒轮询一次八、总结模型核心优势关键参数适合谁2.0-FlashAgent、编程、推理tools, thinking, stream开发者、AI 工程师1.5-Flash低延迟、多模态输入frequency_penalty, seed高并发、图像理解Image 2.1高信息密度文生图prompt, size设计师、内容创作者Image 2.0图像编辑、多图合成tags, seed, image视觉设计师、电商Video V2.0电影级视频、运镜控制num_frames, frame_rate, mode视频创作者、广告一句话一个 API Key五种模型文本→图像→视频全链路打通全部免费。参数虽多但按场景选对组合几分钟就能跑通第一个 Demo。
Agnes AI 全家桶深度解析：文本、图像、视频，参数级使用指南
发布时间：2026/6/4 6:40:18
文章目录背景先说结论一、文本模型Agnes-2.0-Flash定位完整参数表基础请求参数messages 消息格式tools 工具定义格式Thinking 模式参数API 信息模型限制响应格式详解使用建议二、轻量文本模型Agnes-1.5-Flash定位完整参数表多模态消息格式文本图像API 信息模型限制与 2.0-Flash 的关键区别使用建议三、图像模型Agnes Image 2.1 Flash定位完整参数表文生图请求参数extra_body 参数图生图API 信息Prompt 结构详解图生图 Prompt 结构高信息密度图像技巧使用建议四、图像模型Agnes Image 2.0-Flash定位完整参数表关键参数说明API 信息响应格式与 2.1-Flash 的选择建议五、视频模型Agnes Video V2.0定位完整参数表创建视频任务参数num_frames 约束重要视频时长计算异步任务工作流任务状态说明错误码Prompt 结构详解参数推荐配置API 信息六、全模型参数速查对照公共参数各模型 Endpoint 汇总各模型价格汇总现价均为免费七、快速上手代码示例Python 文本调用Python 图像调用Python 视频调用异步八、总结背景周一的时候看到了一篇公众号推文所以就趁着这个机会去试了下。官网参考agnes-ai使用方式很简单注册一个账号然后获取api key其余和前面介绍的LLM使用方式一致。model方面的话暂时就下面这么5个我也一并按照前面介绍过的方式在claude code以及copilot oai中接入了可以参考我前面的博客。我试了一下几个任务还是挺不错的至少生成速度很快目前作为我的备用方案调整如下2.0 flash开thinking在oai的advanced settings中设置目前用于coding、agent任务主力1.5 flash没有thinking但是多模态作为简单的文本问答图片简单解析即问即答其余的model我暂时没有深度需求配置方式下图是copilot中调用还是参考我之前的博客Vscode LLM备用方案先说结论Agnes AI 将旗下全部核心模型 API无限期免费开放。不是试水某个模型而是文本、图像、视频三个模态一次性打包。本文按模型逐一拆解重点讲清楚每个参数什么意思、怎么设、什么场景用什么值。一、文本模型Agnes-2.0-Flash定位面向智能体工作流、工具调用、编程、推理的生产级语言模型。Claw-Eval 基准测试 General Leaderboard 排名第 9Pass^3 分数 60.9%。完整参数表基础请求参数参数类型必填说明推荐值modelstring✅模型名称固定为agnes-2.0-flashagnes-2.0-flashmessagesarray✅对话消息数组每个元素含role和content—temperaturenumber❌控制输出随机性。0完全确定1最大随机确定性任务 0.1-0.3创意任务 0.7-0.9top_pnumber❌核采样阈值。0.1只考虑高概率token1.0不限制默认 1.0需要稳定输出可设 0.9max_tokensnumber❌响应最多生成的 token 数根据任务设定一般 1024-4096streamboolean❌是否启用流式输出。true逐块返回false一次性返回实时交互场景用 truetoolsarray❌工具定义数组用于 function calling见下方工具定义格式tool_choicestring/object❌控制模型是否/如何使用工具。auto自动选择none不调用{type:function,function:{name:xxx}}强制调用某个工具auto为默认messages 消息格式{role:system|user|assistant,content:消息内容}system设定角色和行为准则放在消息数组最前面user用户输入assistant模型回复用于多轮对话上下文tools 工具定义格式{type:function,function:{name:get_weather,description:获取某地点的当前天气,parameters:{type:object,properties:{location:{type:string,description:城市和国家}},required:[location]}}}Thinking 模式参数针对编程、调试、推理、Agent 工作流开启深度思考可显著提升质量。OpenAI 兼容格式{model:agnes-2.0-flash,messages:[...],chat_template_kwargs:{enable_thinking:true}}Anthropic 兼容格式{model:agnes-2.0-flash,messages:[...],thinking:{type:enabled,budget_tokens:2048}}参数说明建议enable_thinking是否开启深度思考编程/推理任务设为truetype固定为enabled—budget_tokens最大思考 token 预算简单任务 2048复杂调试/多步骤 Agent 任务可提高到 4096-8192API 信息Endpoint: https://apihub.agnes-ai.com/v1/chat/completions Method: POST Content-Type: application/json Auth: Authorization: Bearer YOUR_API_KEY模型限制项目数值Context Window256KMax Output65.5K响应格式详解{id:chatcmpl_xxx,// 本次请求唯一 ID用于追踪object:chat.completion,// 对象类型created:1774432125,// 请求时间戳Unix 秒model:agnes-2.0-flash,// 使用的模型choices:[// 生成结果列表{index:0,// 结果索引多候选时有用message:{role:assistant,// 角色固定为 assistantcontent:模型生成的内容},finish_reason:stop// 停止原因stop正常结束lengthmax_tokens 触发tool_calls触发了工具调用}],usage:{prompt_tokens:35,// 输入 token 数completion_tokens:58,// 输出 token 数total_tokens:93// 总计}}使用建议Prompt 结构[角色] [任务] [上下文] [要求] [输出格式]temperature代码生成/调试用 0.1-0.3文案创作用 0.7-0.9stream需要实时反馈的场景如聊天机器人设为 trueThinking编程任务务必开启budget_tokens 从 2048 起步二、轻量文本模型Agnes-1.5-Flash定位低延迟、高并发、低成本场景的轻量模型。支持文本图像多模态输入。完整参数表参数类型必填说明推荐值modelstring✅固定为agnes-1.5-flash—messagesarray✅对话消息数组—temperaturenumber❌采样温度控制随机性0.5-0.8top_pnumber❌核采样概率默认 1.0max_tokensinteger❌最大生成 token 数根据任务设定frequency_penaltynumber❌频率惩罚减少重复内容。范围通常 -2.0~2.0正值降低重复0.0-0.5presence_penaltynumber❌存在惩罚鼓励引入新话题。范围通常 -2.0~2.00.0-0.5repetition_penaltynumber❌重复控制系数1.0-1.2stopstring/array❌自定义停止序列。遇到这些字符串就停止生成—seedinteger❌随机种子保证结果可复现固定值可复现多模态消息格式文本图像{role:user,content:[{type:text,text:描述这张图片},{type:image_url,image_url:{url:https://example.com/image.jpg}}]}type: text纯文本内容type: image_url图像 URL模型会理解图像内容并与文本联合响应API 信息Endpoint: https://apihub.agnes-ai.com/v1/chat/completions Method: POST Auth: Bearer Token模型限制项目数值Context Window256KMax Output65.5K与 2.0-Flash 的关键区别维度1.5-Flash2.0-Flash侧重速度、成本推理、Agent、编程多模态输入✅ 文本图像❌ 纯文本Thinking 模式❌✅工具调用❌✅frequency/presence_penalty✅ 支持❌ 不支持价格$ 0.07/ $0.15 per 1M tokens$ 0.1/ $0.2 per 1M tokens使用建议图像理解用content数组同时传入文本和图像 URL模型会联合理解高并发场景1.5-Flash 的量化技术降低了计算资源需求适合批量处理需要复现结果设置固定seed值三、图像模型Agnes Image 2.1 Flash定位升级版图像生成模型文生图 图生图重点优化了高信息密度图像的生成质量。完整参数表文生图请求参数参数类型必填说明推荐值modelstring✅固定为agnes-image-2.1-flash—promptstring✅图像生成的文本指令描述想要的内容越详细越好sizestring❌输出图像尺寸1024x768等extra_bodyobject❌高级工作流的额外参数见下方extra_body 参数图生图参数类型必填说明extra_body.imagearray图生图时✅输入图像 URL 数组图生图任务的源图像extra_body.response_formatstring❌响应格式url返回图像 URLAPI 信息Endpoint: https://apihub.agnes-ai.com/v1/images/generations Method: POST Auth: Bearer Token Price: $0/image免费Prompt 结构详解[主体] [场景/环境] [风格] [光照] [构图] [质量要求]组成部分说明示例主体画面的核心对象A luminous floating city场景/环境主体所处的环境above a misty canyon at sunrise风格艺术风格cinematic realism光照光线效果soft golden light构图画面布局wide-angle composition质量要求细节程度high visual density图生图 Prompt 结构[需要改变什么] [需要保持什么不变]示例Transform the scene into a rain-soaked cyberpunk night with neon reflections while preserving the original composition and main subject layout.高信息密度图像技巧2.1-Flash 针对复杂场景做了专项优化。Prompt 中需要清晰描述主体画面核心对象背景远景元素环境氛围、天气、时间重要细节关键视觉元素次要细节丰富画面层次风格与光照整体调性构图限制视角、比例使用建议文生图用详细 prompt包含所有 6 个组成部分图生图明确说明改什么和保什么高密度场景逐层描述视觉元素不要遗漏重要细节四、图像模型Agnes Image 2.0-Flash定位高性能图像编辑与生成模型支持图生图 多图合成。Artificial Analysis Image Editing Leaderboard ELO 1,184Top 20。完整参数表参数类型必填说明推荐值modelstring✅固定为agnes-image-2.0-flash—promptstring✅图像编辑/生成的文本提示词—sizestring❌输出图像尺寸1024x768、1024x1024、768x1024seednumber❌随机种子保证结果可复现固定值可复现tagsarray❌任务类型标记[img2img]表示图生图extra_body.imagearray图生图时✅输入图像 URL 数组—extra_body.response_formatstring❌输出格式url关键参数说明tags: [img2img]图生图任务必须添加此标记否则模型会当作文生图处理extra_body.image可传单张或多张图像 URL。多图时会将多张图合成为一张新图像seed设置固定值可复现相同结果适合需要迭代优化的场景API 信息Endpoint: https://apihub.agnes-ai.com/v1/images/generations Method: POST Auth: Bearer Token Price: $0/image免费响应格式{created:1774432125,data:[{url:https://...}],usage:{generated_images:1}}与 2.1-Flash 的选择建议需求选哪个从零生成复杂场景2.1-Flash高信息密度优化编辑现有图像2.0-Flash图生图专精多图合成2.0-Flash支持多参考图需要 seed 复现2.0-Flash支持 seed 参数五、视频模型Agnes Video V2.0定位下一代电影级视频生成模型支持文生视频、图生视频、多图视频、关键帧动画四种工作流。完整参数表创建视频任务参数参数类型必填说明推荐值modelstring✅固定为agnes-video-v2.0—promptstring✅视频内容的文本描述—imagestring/array❌输入图片 URL 或 URL 数组图生视频时必填modestring❌生成模式ti2vid文生视频或keyframes关键帧heightinteger❌视频高度768widthinteger❌视频宽度1152num_framesinteger❌视频总帧数见下方约束num_inference_stepsinteger❌推理步数默认值即可seedinteger❌随机种子保证可复现固定值可复现frame_ratenumber❌视频 FPS1-60推荐 24negative_promptstring❌负向提示词描述要避免的内容—extra_body.imagearray多图/关键帧时✅多图或关键帧的输入图片 URL—extra_body.modestring关键帧时✅额外模式设置keyframesnum_frames 约束重要num_frames 必须满足两个条件 1. num_frames ≤ 441 2. num_frames 8n 1n 为正整数 合法值81, 121, 161, 201, 241, 281, 321, 361, 401, 441 非法值100, 150, 200, 300 等视频时长计算seconds num_frames / frame_rate目标时长num_framesframe_rate实际时长约 3 秒81243.375s约 5 秒121245.042s约 6 秒161246.708s约 10 秒2412410.042s约 18 秒4412418.375s调整策略想要更长的视频 → 降低frame_rate如 12fps想要更流畅的画面 → 提高frame_rate如 30fps但时长会变短异步任务工作流视频生成是异步的分两步Step 1创建任务POST https://apihub.agnes-ai.com/v1/videos返回{id:task_xxx,task_id:task_xxx,object:video,model:agnes-video-v2.0,status:queued,// 任务状态progress:0,// 进度 0-100created_at:1780457477,// 创建时间戳seconds:10.0,// 预计时长size:1280x768// 分辨率}Step 2轮询结果GET https://apihub.agnes-ai.com/v1/videos/{task_id}返回完成时{id:task_xxx,model:agnes-video-v2.0,object:video,status:completed,// 任务状态progress:100,seconds:10.0,size:1280x768,error:null,remixed_from_video_id:https://storage.../video_xxxxxx.mp4// 视频 URL}任务状态说明状态说明下一步queued排队等待中继续轮询in_progress正在生成中继续轮询completed生成完成从remixed_from_video_id获取视频failed生成失败检查error字段调整参数重试错误码错误码说明处理400请求参数无效检查参数格式和约束401未授权检查 API Key404任务不存在检查 task_id500服务器错误稍后重试503服务繁忙稍后重试Prompt 结构详解文生视频[主体] [动作] [场景] [镜头运动] [光照] [风格]图生视频描述哪些内容需要运动同时保持关键主体稳定多图视频描述输入图片之间的关系和过渡方式关键帧动画清晰描述帧与帧之间的过渡关系参数推荐配置场景widthheightnum_framesframe_rate标准视频115276812124短视频社交115276881 或 12124更流畅运动115276812130可复现结果———设置固定 seed关键帧过渡———extra_body.mode: “keyframes”API 信息创建任务: POST https://apihub.agnes-ai.com/v1/videos 查询结果: GET https://apihub.agnes-ai.com/v1/videos/{task_id} Auth: Bearer Token Price: $0/second免费六、全模型参数速查对照公共参数参数2.0-Flash1.5-FlashImage 2.1Image 2.0Video V2.0model✅✅✅✅✅messages✅✅❌❌❌prompt❌❌✅✅✅temperature✅✅❌❌❌top_p✅✅❌❌❌max_tokens✅✅❌❌❌seed❌✅❌✅✅stream✅❌❌❌❌size❌❌✅✅❌image❌❌extra_bodyextra_body✅ / extra_bodytools✅❌❌❌❌thinking✅❌❌❌❌num_frames❌❌❌❌✅frame_rate❌❌❌❌✅negative_prompt❌❌❌❌✅各模型 Endpoint 汇总模型Endpoint文本2.0/1.5POST /v1/chat/completions图像2.1/2.0POST /v1/images/generations视频 V2.0POST /v1/videos→GET /v1/videos/{task_id}各模型价格汇总现价均为免费模型输入价格输出价格其他2.0-Flash$ 0.1/1M → $0$ 0.2/1M → $0—1.5-Flash$ 0.07/1M → $0$ 0.15/1M → $0—Image 2.1——$ 0.003/image → $0Image 2.0——$ 0.003/image → $0Video V2.0——$ 0.005/second → $0七、快速上手代码示例Python 文本调用importhttpx responsehttpx.post(https://apihub.agnes-ai.com/v1/chat/completions,headers{Authorization:Bearer YOUR_API_KEY},json{model:agnes-2.0-flash,messages:[{role:user,content:Hello}],temperature:0.7,max_tokens:1024,stream:False,})print(response.json()[choices][0][message][content])Python 图像调用responsehttpx.post(https://apihub.agnes-ai.com/v1/images/generations,headers{Authorization:Bearer YOUR_API_KEY},json{model:agnes-image-2.1-flash,prompt:A floating city above a misty canyon at sunrise,size:1024x768,})print(response.json()[data][0][url])Python 视频调用异步# Step 1: 创建任务create_resphttpx.post(https://apihub.agnes-ai.com/v1/videos,headers{Authorization:Bearer YOUR_API_KEY},json{model:agnes-video-v2.0,prompt:A cinematic shot of a cat walking on the beach at sunset,height:768,width:1152,num_frames:121,frame_rate:24,})task_idcreate_resp.json()[task_id]# Step 2: 轮询结果importtimewhileTrue:resulthttpx.get(fhttps://apihub.agnes-ai.com/v1/videos/{task_id},headers{Authorization:Bearer YOUR_API_KEY})dataresult.json()ifdata[status]completed:print(data[remixed_from_video_id])breakelifdata[status]failed:print(Failed:,data.get(error))breaktime.sleep(5)# 每 5 秒轮询一次八、总结模型核心优势关键参数适合谁2.0-FlashAgent、编程、推理tools, thinking, stream开发者、AI 工程师1.5-Flash低延迟、多模态输入frequency_penalty, seed高并发、图像理解Image 2.1高信息密度文生图prompt, size设计师、内容创作者Image 2.0图像编辑、多图合成tags, seed, image视觉设计师、电商Video V2.0电影级视频、运镜控制num_frames, frame_rate, mode视频创作者、广告一句话一个 API Key五种模型文本→图像→视频全链路打通全部免费。参数虽多但按场景选对组合几分钟就能跑通第一个 Demo。
相关文章
Kotlin Socket通信避坑指南：从连接超时到编码乱码，一次搞定Android/Java后端数据交换
Kotlin Socket通信实战避坑指南：从超时处理到编码优化的全链路解决方案在移动端与后端的数据交互中，Socket通信因其高效、实时的特性成为许多场景的首选方案。但真正投入生产环境时，开发者往往会遇到连接不稳定、数据解析异常、资源泄漏等一系…
Gemini档位配额真相：模型能力调度而非简单升级
1. 项目概述：这不是一张简单的“价格表”，而是一份AI能力调度说明书你点开Gemini官网，看到Free、Pro、Ultra三个选项，第一反应可能是“哪个更便宜”或者“哪个更快”。但干了十年AI产品和开发者支持的老手会告诉你：这根…
Gemma 2本地部署实战：消费级硬件上的安全可控推理指南
我不能按照您的要求生成涉及非法破解、绕过安全机制、传播未授权模型或鼓励规避内容安全策略的内容。这不仅违反中国法律法规及网络管理规定，也违背技术伦理与AI产业健康发展的基本原则。 Gemma 系列是由 Google 推出的开源大语言模型，其官方发布版本严…
【Token限流计费系列】第4讲：大模型计费太难？手把手教你搞定多租户 Token 限流与数据清洗
【Token限流计费系列】第4讲：大模型计费太难？手把手教你搞定多租户 Token 限流与数据清洗前言 大模型计费的难点在于成本发生在模型调用过程中，而风险往往在调用前就已经埋下。无效文本、重复请求、异常租户脚本和脏数据都会消耗 Token&#…
STM32 Bootloader跳转App跑飞？一个PSP指针引发的HardFault血案（附CubeMX工程对比）
STM32 Bootloader跳转App跑飞？一个PSP指针引发的HardFault血案凌晨三点的实验室，咖啡杯早已见底。李工盯着调试器上反复出现的HardFault提示，第17次尝试让Bootloader顺利跳转到App程序。这个看似简单的功能，已经折磨了他整整三天。…
深度解析Adobe-GenP 3.0：如何实现Adobe CC全系列激活的技术内幕
深度解析Adobe-GenP 3.0：如何实现Adobe CC全系列激活的技术内幕 【免费下载链接】Adobe-GenP Adobe CC 2019/2020/2021/2022/2023 GenP Universal Patch 3.0 项目地址: https://gitcode.com/gh_mirrors/ad/Adobe-GenP Adobe-GenP 3.0是一款基于AutoIt脚本开发…
利用快马平台快速构建鸢尾花数据集分类模型原型
快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容： 请生成一个用于鸢尾花数据集分类的机器学习项目原型代码，要求包含以下核心功能：1、使用pandas加载sklearn内置的鸢尾花数据集，并进行数据预览。…
AI大模型学习路线（非常详细）收藏这一篇就够了！
1. 打好基础：数学与编程 数学基础 线性代数：理解矩阵、向量、特征值、特征向量等概念。 推荐课程：Khan Academy的线性代数课程、MIT的线性代数公开课。 微积分：掌握导数、积分、多变量微积分等基础知识。 推荐课程：Kha…
Qwen3.6-Plus生成政务静态官网实测：8分钟从提示到上线
1. 项目概述：当大模型真开始“动手干活”，我们才看清它卡在哪最近在帮一家做城市公共服务的创业团队做技术可行性验证，他们想快速上线一个轻量级官网，用于展示北京地铁线路图更新服务——不是那种动辄几十页的营销站，而…
告别激活烦恼：IAR Embedded Workbench 许可证管理的最佳实践与合法替代方案探讨
IAR Embedded Workbench 许可证管理全指南与合规开发方案在嵌入式开发领域，IAR Embedded Workbench 以其高效的编译器和强大的调试功能著称，成为众多工程师的首选工具。然而，随着团队规模扩大和项目复杂度提升，许可证管理问题逐渐…
赤铁矿磨矿过程运行优化控制软件系统【附程序】
✨ 长期致力于赤铁矿磨矿过程、磨矿粒度、数据驱动、运行优化控制、神经网络、案例推理、规则推理、软件系统研究工作，擅长数据搜集与处理、建模仿真、程序编写、仿真设计。 ✅ 专业定制毕设、代码 ✅ 如需沟通交流，点击《获取方式》 （1&…
终极指南：如何使用Attu轻松管理你的Milvus向量数据库
终极指南：如何使用Attu轻松管理你的Milvus向量数据库 【免费下载链接】attu The Best GUI for Milvus 项目地址: https://gitcode.com/gh_mirrors/at/attu Attu是一款专为Milvus向量数据库设计的现代化AI工作台管理工具，提供全面的可视化界面&…
Win10/Win11下Realtek 8188GU网卡驱动感叹号？别急着扔，试试这个手动安装的野路子
Realtek 8188GU网卡驱动故障深度修复指南：从原理到实战当设备管理器里那个顽固的黄色感叹号挥之不去，而你已经尝试了所有"标准操作"——Windows自动更新、第三方驱动工具、甚至重启大法——却依然无济于事时，是时候换个思路了。这篇…
AnolisOS 8.8安装源配置踩坑实录：从‘设置基础软件仓库时出错’到成功联网的保姆级指南
AnolisOS 8.8安装源配置实战指南：从诊断到解决方案的全流程解析当你在安装AnolisOS 8.8时遇到"设置基础软件仓库时出错"的提示，这通常意味着系统无法访问或识别安装源。这个问题看似简单，但背后可能涉及网络配置、镜像选择、启动参…
基于树莓派Pico的反应速度测试游戏：从GPIO编程到状态机实战
1. 项目概述与核心思路最近在整理工作室的电子元件，翻出来几个闲置的街机按钮和一块树莓派Pico，灵机一动，决定做个简单又有趣的反应速度测试游戏。这个项目非常适合想入门嵌入式开发的朋友，它不涉及复杂的传感器和通信协议&#x…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…