xmsmartlink Docs

外观

图片系列总览 ​

xmsmartlink Docs 的图片能力覆盖文生图、图像编辑以及异步图片任务处理，既支持常见的 OpenAI 风格图片入口，也包含适合批量生成或耗时任务的异步调用方式。对于需要统一管理多种图片模型的场景，可以先按任务类型选择入口，再根据效果、成本和响应时延选择具体模型。

同步接口通常适合交互式生成和在线编辑；异步任务更适合高分辨率、多张图片生成或需要在服务端稳定轮询结果的业务流程。如果你还不确定入口差异，建议先从最贴近你现有应用协议的接口开始。

覆盖范围 ​

  • 图片生成：根据文本提示生成图片
  • 图片编辑：基于已有图片进行局部修改、重绘或增强
  • 异步任务：先提交任务，再按任务 ID 轮询生成结果

推荐入口 ​

  • POST /v1/images/generations
  • POST /v1/images/edits
  • POST /v1/aigc-images/generations
  • GET /v1/aigc-images/generations/{task_id}
  • POST /v1beta/models/gemini-3-pro-image-preview:generateContent
  • POST /v1beta/models/gemini-2.5-flash-image:generateContent

选择建议：

  • 需要快速接入 OpenAI 风格文生图：使用 POST /v1/images/generations
  • 需要基于已有图片做编辑：使用 POST /v1/images/edits
  • 需要处理耗时较长或批量生成任务：使用异步创建与查询接口
  • 已有 Gemini 图像调用链路：使用对应 generateContent 图片入口

适用场景 ​

  • 海报、封面、插画生成
  • 商品图、营销素材制作
  • 基于原图的局部编辑与风格改写
  • 批量生成图片资产
  • 服务端任务队列与异步回调前的轮询集成

参考接口文档 ​

接入前建议先确认目标接口的输入格式、支持的图片数量、返回 URL 结构，以及异步任务的状态字段定义。