---
title: "图片生成接口"
method: POST
path: "/images/generations"
tags: ["Image"]
---

# 图片生成接口

`POST /images/generations`

基于文本提示生成AI图片的接口，支持多种图片生成模型和参数配置

## Request body

- object
  - `model` string, required — 图片生成模型
  - `prompt` string, required — 文本提示
  - `negative_prompt` string — 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制
  - `image` union
    - string — 单张图片URL/Base64编码数据，仅支持图生图模型支持该配置
    - string[] — 多张图片URL/Base64编码数组列表，仅支持图生图模型支持该配置
  - `strength` number — 以图生图引用图片的影响强度，取值范围[0, 1]，默认0.5
  - `size` string — 图片尺寸，不同模型设置不同，详见模型尺寸表
  - `aspect_ratio` string — 图片宽高比，不同模型设置不同，详见模型尺寸表
  - `n` integer — 图片数量，默认为1
  - `quality` string — 图片质量，可灵AI支持 std、pro 两个配置，OpenAI/智谱清言支持 standard、hd 两个配置，GPT Image支持 auto/low/medium/high 四个配置项
  - `style_preset` string — 风格预设，目前仅 stable image 支持该配置
  - `response_format` 'url' | 'b64_json' — 图片响应格式，支持 url/b64_json 两种格式，默认为url
  - `output_format` 'png' | 'jpg' | 'webp' — 图片输出格式，支持 png/jpg/webp 三种格式，默认为png
  - `mask` string — 图片遮罩，支持图片URL/Base64编码数据
  - `watermark` boolean — 是否添加AI生成水印，默认为false，仅部分模型支持
  - `background` 'transparent' | 'opaque' | 'auto' — 背景透明度，目前仅 gpt-image-1 支持该配置
  - `extra_body` object — 额外参数配置项，以适配不同画图模型的多样化配置
    - `sequential_image_generation` 'auto' | 'disabled' — 控制是否关闭组图功能，仅 doubao-seedream-4.0 支持该参数，默认disabled
    - `sequential_image_generation_options` object — 组图功能的配置，仅当 sequential_image_generation 为 auto 时生效。仅 doubao-seedream-4.0 支持该参数。
      - `max_images` integer — 组图张数，取值范围1-15，默认15
  - `async` boolean — 是否异步生成，默认false，即同步等待图片生成成功后返回生成结果，如果异步需要通过调用图片获取接口获取生成结果
  - `retries` integer — 自动重试次数，默认0，表示失败不重试

## Response `200`

成功响应

- object
  - `task_id` string, uuid — 图片生成任务ID
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed' — 任务状态
  - `created` integer, required — 创建时间戳
  - `data` object[], required — 生成的图片列表(仅在task_status=succeed时返回)
    - `url` string, uri, required — 图片URL
    - `b64_json` string, base64 — 图片Base64编码数据
    - `revised_prompt` string — 优化后的提示文本

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `413` — 提示文本过长
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)