概览/OpenAPI/AI 生图

AI 生图

Nano Banana 2 与 GPT Image 2 请求示例。

AI 生图

AI 生图使用 image。先从 Catalog 的 generation_models[] 选择模型,再使用模型支持的比例。

Nano Banana 2

{  "type": "image",  "prompt": "一张简洁的二分查找课程封面,深色矢量风格",  "aspect_ratio": "16:9",  "output_quality": "2K",  "image_generation": {    "provider": "gemini",    "model": "nano-banana-2"  }}

支持比例以 Catalog 为准,当前为 16:9 / 9:16 / 1:1

GPT Image 2

{  "type": "image",  "prompt": "一张适合开发者课程的二分查找海报,准确清晰的数组视觉",  "aspect_ratio": "3:2",  "output_quality": "2K",  "image_generation": {    "provider": "azure_openai",    "model": "gpt-image-2",    "quality": "medium"  }}

GPT Image 2 当前比例为 3:2 / 2:3 / 1:1,原生 quality 使用 low / medium / high。它与顶层最终输出规格 output_quality 是两个不同维度。

请使用 Public OpenAPI schema 中的顶层 aspect_ratiooutput_quality 字段。

为单张视觉结果选择 AI 生图

插图、封面、视觉参考或图解式构图适合使用 AI 生图。提示词应说明主体、使用场景、构图和视觉方向。生成图像在代表事实来源前仍需要审核:准确文字、密集表格和具法律意义的标签,应由人工核对,而不是只依赖提示词。

匹配 provider 与模型字段

构造 image_generation 前先读取 /catalog。选择模型后,只使用该模型允许的比例和质量值。OpenAPI 的 provider 与模型位于 image_generation 内,交付规格保留在顶层。不要把 MCP 的扁平 image 字段移入该请求,也不要将一个 provider 的比例与另一个 provider 的模型组合。

调用 POST /creations 后,轮询任务并读取完成详情,以获得返回的 main_url 与资产。若校验失败,先更新来自 Catalog 的设置或补充提示词,再提交一次新的重试。

关联文档