图像生成API调用

入门·10 分钟·通过可运行代码讲解「图像生成API调用」,覆盖环境准备、核心代码、参数说明、异常处理、工程化改造和练习任务,适合 AI 编程入门。

图像生成API调用

图像生成 API 可以根据文本提示词生成图片,也可以基于参考图做变化、扩展或局部修改。学习这类 API 的重点不是只生成一张图,而是理解提示词、尺寸、风格、成本、审核和文件保存流程。

基本调用流程

图像生成通常包含五步:

  1. 准备提示词;
  2. 设置尺寸、数量和质量参数;
  3. 调用图像生成接口;
  4. 获取图片 URL 或 base64 数据;
  5. 下载保存并记录提示词和参数。

如果不记录提示词和参数,后面很难复现同类效果。

提示词怎么写

一个可用提示词通常包含:主体、场景、风格、光线、构图和限制。

一只橘猫坐在窗边,清晨阳光,柔和光线,写实摄影风格,浅景深,高细节

如果用于产品图,还要补充背景、角度、材质、品牌限制和不可出现的元素。

Python伪代码结构

prompt = '一张极简风格的AI学习路线海报,蓝紫渐变,清晰标题区域'
 
result = image_client.generate(
    prompt=prompt,
    size='1024x1024',
    quality='standard',
)
 
image_url = result['url']
download(image_url, 'output/poster.png')

不同平台 SDK 不同,但整体流程类似。

保存生成记录

建议每次生成都保存一条 JSON 记录:

{
  "prompt": "...",
  "size": "1024x1024",
  "model": "image-model",
  "output": "output/poster.png"
}

这样你可以回溯哪张图来自哪个提示词。

常见问题

  • 图中文字乱码:很多图像模型不擅长稳定生成文字,标题建议后期排版。
  • 人物手部异常:可以多生成几张筛选,或用局部修复。
  • 风格不稳定:固定风格词、参考图或种子。
  • 成本过高:限制尺寸、数量和重试次数。
  • 版权风险:不要要求模仿具体在世艺术家或生成侵权商标。

适合练习的项目

做一个“文章封面生成器”:输入文章标题和分类,自动生成 3 个封面提示词,调用 API 生成图片,并保存提示词、图片路径和时间。

小结

图像生成 API 的关键是可控和可复现。提示词、参数、保存记录、人工筛选和版权检查缺一不可。