概览/OpenAPI/AI 生图

AI 生图

选择模型、比例和质量生成图片。

AI 生图

AI 生图使用 type: image。先从 GET /capabilities 的 image.models 中选择一个完整模型组合。

Nano Banana 2

{  "type": "image",  "prompt": "一张简洁的二分查找课程封面,深色科技风格",  "input_file_ids": [],  "image": {    "provider": "gemini",    "model": "nano-banana-2",    "aspect_ratio": "16:9",    "output_quality": "2K",    "style_id": "style_from_capabilities"  }}

GPT Image 2

{  "type": "image",  "prompt": "一张面向开发者的二分查找课程海报,构图清晰",  "image": {    "provider": "azure_openai",    "model": "gpt-image-2",    "aspect_ratio": "3:2",    "output_quality": "2K",    "quality": "medium"  }}

参数说明

  • provider 与 model 必须成组选择,不能交叉组合。
  • aspect_ratio 和 output_quality 必须属于该模型组合。
  • quality 是 GPT Image 的原生质量档位,仅用于 azure_openai + gpt-image-2。
  • style_id 从 capabilities 返回的风格中选择。
  • 三类产品都支持 input_file_ids;参考图片或文档先上传。
  • AI 生图当前不声明 URL Context,不要声称已经读取 prompt 中的网页。

使用建议

提示词写清楚主体、用途、构图、受众和视觉方向。若图片需要准确文字、数据、商标或合规标签,交付前仍应人工核对。创建后查询同一个 creation,ready 后再读取 outputs。