---
title: "生成图像"
method: POST
path: "/api/ai/image/generate"
tags: ["AI 服务/图像生成"]
---

# 生成图像

`POST /api/ai/image/generate`

接口说明：同步生成图像，根据所选模型与提示词返回生成结果。

调用本接口前，请先请求[「图像生成模型」](/api-reference/get-api-ai-models-image-generation)接口（`GET /api/ai/models/image/generation`），获取当前可用的模型列表及各模型支持的尺寸、质量、风格与价格，再据此填写本接口参数。

图像生成为**文生图**：仅通过文字提示词生成全新图像，不传入图片。如需基于已有图片进行修改、重绘（图生图），请使用[「编辑图像」](/api-reference/post-api-ai-image-edit)接口。

如已在使用 OpenAI SDK 或生态工具，可改用 OpenAI 兼容端点[「OpenAI 图像生成」](/api-reference/post-api-ai-images-generations)。

## Request body

- object
  - `prompt` string, required — 图片描述提示
  - `model` string, required — 图像生成模型名称。先调用[「图像生成模型」](/api-reference/get-api-ai-models-image-generation)接口（`GET /api/ai/models/image/generation`），传入其返回的 `data[n].name`；各模型支持的尺寸、质量、风格与价格以该接口返回为准。
  - `quality` string — 图像质量。可选值随模型而不同，以[「图像生成模型」](/api-reference/get-api-ai-models-image-generation)接口返回的 `data[n].qualities` 为准。
  - `response_format` 'url' | 'b64_json' — 返回格式
  - `size` string — 图像尺寸。可选值随模型而不同，以[「图像生成模型」](/api-reference/get-api-ai-models-image-generation)接口返回的 `data[n].sizes` 为准；不同尺寸的价格不同，见 `data[n].pricing`。
  - `style` string — 图像风格。可选值随模型而不同，以[「图像生成模型」](/api-reference/get-api-ai-models-image-generation)接口返回的 `data[n].styles` 为准；返回为空表示该模型不支持风格参数。

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` ImageResponseVo
    - `created` number, required — 创建时间戳
    - `list` object[], required — 生成的图片列表
      - `url` string — 图片URL
      - `b64_json` string — base64编码的图片
      - `revised_prompt` string — 修订后的提示词
    - `usage` object — token使用情况
      - `input_tokens` number — 输入token数
      - `output_tokens` number — 输出token数
      - `total_tokens` number — 总token数
    - `background` string — 背景
    - `output_format` string — 输出格式
    - `quality` string — 质量档位
    - `size` string — 图片尺寸
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)