切换主题
图像生成总览
这个能力能做什么
适用于文本生图、参考图融合、电商海报生成等场景。当前站点同时覆盖两种接入方式：
- 同步直返：直接读取
:generateContent响应体中的图片结果 - 异步任务：先提交任务，再通过
/v1/tasks/*轮询最终结果
域名选择
text
同步图像生成 Base URL: https://api.xinbao-ai.com
异步生图 Base URL: https://async.xinbao-ai.com如果只是普通同步 generateContent，优先走主站域名。只有接入异步生图任务流时，才切到 async.xinbao-ai.com。
支持的模型
根据线上渠道说明，当前以图像生成预览模型为主，例如：
gemini-3-pro-image-preview
如果后续新增图像模型，建议继续归入本栏目。
请求入口
text
POST https://api.xinbao-ai.com/v1beta/models/{model}:generateContent如果你的渠道挂了异步生图网关，还会额外用到：
text
POST https://async.xinbao-ai.com/v1beta/models/{model}:generateContent
GET https://async.xinbao-ai.com/v1/tasks
POST https://async.xinbao-ai.com/v1/tasks/batch-get
GET https://async.xinbao-ai.com/v1/tasks/{id}
GET https://async.xinbao-ai.com/v1/tasks/{id}/content两种返回模式
同步直返
- 请求成功后通常直接返回
200 - 图片结果位于
candidates[*].content.parts[*].inlineData - 默认使用
https://api.xinbao-ai.com - 适合前台调试或短耗时图像生成
异步任务
- 提交入口仍然是
POST /v1beta/models/{model}:generateContent - 响应通常为
202 Accepted - 返回
id、polling_url、content_url - 多任务客户端可改用
POST /v1/tasks/batch-get统一轮询多个进行中任务 - 默认使用
https://async.xinbao-ai.com - 适合耗时更长、需要可靠恢复和后台轮询的场景
典型参数
contents[].parts[].text：主提示词contents[].parts[].inlineData：同步直返场景可用 URL 或 base64，异步生图只接受 URLgenerationConfig.responseModalities=["IMAGE"]：要求返回图片结果generationConfig.imageConfig.output：建议优先用url
输入限制
- 当前异步网关图片输入上限为 8 张
- 异步网关只接受公网
http/https图片 URL，不接收 base64 参考图 - 异步网关解压后的请求体上限为
2 MB - 异步网关提示词总文本长度上限为
4000字符 - 大图建议优先传公网 URL，避免请求体过大
- URL 方式更适合重试和下载