图片技术 · 异步任务接口

AI生图API：gpt-image-2 与 nano-banana-2

轻语API提供可直接集成的AI图片生成与图片编辑能力。调用 image_generation 提交提示词，可完成文生图；传入参考图后可进行图片编辑。模型参数选填，默认使用 gpt-image-2，也可选择 nano-banana-2，生成结果通过异步查询接口获取。

在线调试 image_generation 查询 image_generation_status

AI图片生成与编辑API参数界面，model默认选择gpt-image-2并可选nano-banana-2 — 生产接口文档界面：prompt 必填，model 选填且默认 gpt-image-2。

gpt-image-2 与 nano-banana-2 模型选择

创建任务时不传 model 即使用默认模型；需要另一模型时，按下表传入精确编码。

模型编码	是否默认	单次消耗	调用方式
`gpt-image-2`	默认	120 金豆	可省略 model，或显式传入该编码
`nano-banana-2`	否	480 金豆	model 必须显式传入该编码

创建与查询流程

生图和图片编辑采用异步任务模式。业务端应保存创建接口返回的任务 ID，并按需查询结果。

1. 提交任务POST 调用 imageGeneration，传入 apikey、prompt 和可选模型参数。
2. 保存 task_id从创建响应中取得任务 ID，避免重复创建相同任务。
3. 查询结果GET 调用状态接口，使用 task_id 获取任务状态及最终图片。

提交 image_generation 任务

请求地址为 POST https://5555api.com/data/api/imageGeneration。其中 apikey 和 prompt 必填，其余参数按业务需要选填。

参数	必填	说明
`apikey`	是	轻语API身份凭证
`prompt`	是	图片生成或编辑提示词
`model`	否	gpt-image-2 或 nano-banana-2，默认 gpt-image-2
`n`	否	生成图片数量，默认 1
`size`	否	图片比例或像素尺寸
`imageSize`	否	清晰度等级：1K、2K 或 4K
`image`	否	参考图 Data URL 数组，用于参考图生成或图片编辑

cURL 示例

curl -X POST "https://5555api.com/data/api/imageGeneration" \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "YOUR_API_KEY",
    "prompt": "一张适合产品详情页的极简摄影图",
    "model": "gpt-image-2",
    "n": 1,
    "size": "1:1",
    "imageSize": "2K"
  }'

进行图片编辑时，将参考图转换为 Data URL 后放入 image 数组；不要在公开页面或客户端代码中暴露正式 API Key。

查询 image_generation_status

查询接口编码为 image_generation_status，请求地址为 GET https://5555api.com/data/api/imageGeneration/status，单次消耗 2 金豆。

cURL 示例

curl -G "https://5555api.com/data/api/imageGeneration/status" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  --data-urlencode "task_id=YOUR_TASK_ID"

常见问题

gpt-image-2和nano-banana-2如何选择？

model不传时默认使用gpt-image-2，单次消耗120金豆；需要使用nano-banana-2时显式传入该模型编码，单次消耗480金豆。

生图接口可以编辑已有图片吗？

可以。image_generation既支持纯提示词生成图片，也支持通过image参数传入参考图Data URL数组进行参考图生成或图片编辑。

如何查询图片任务结果？

创建任务后保存返回的task_id，再调用image_generation_status查询任务状态和结果。查询接口单次消耗2金豆。

model参数必须填写吗？

不必须。model是选填参数，不传时系统默认使用gpt-image-2。prompt是创建任务时的必填参数。