---
title: "POST /v1/playground/images/generations"
method: POST
path: "/v1/playground/images/generations"
tags: ["PlaygroundService"]
---

# POST /v1/playground/images/generations

`POST /v1/playground/images/generations`

GenerateImage 图像生成（同步下载上游结果转存对象存储，返回 presign-download URL）

## Request body

- PlaygroundV1GenerateImageRequest — GenerateImage
  - `apiKeyId` string — 计费身份：用户自己的 API key（按 id 选、无明文），同 playground chat 先例。 proto 层 optional 以兼容旧客户端，service 层强制必填（缺失 → 400）。
  - `model` string
  - `modelId` string
  - `n` integer
  - `prompt` string
  - `quality` string
  - `responseFormat` string
  - `sessionId` string
  - `size` string
  - `style` string

## Response `200`

OK

- PlaygroundV1GenerateImageReply
  - `assetId` string
  - `created` string
  - `data` PlaygroundV1GeneratedImage[]
    - `b64Json` string
    - `revisedPrompt` string
    - `url` string

---

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