> ## Documentation Index
> Fetch the complete documentation index at: https://api.xcompute.us/llms.txt
> Use this file to discover all available pages before exploring further.

# 图像生成

* 图像生成接口
* 该接口通过 OpenAI 中转
* 目前仅支持 `gpt-image-2`

## 说明

* 官方 `1k` 图像通常需要 `60-90s`
* 实际生图耗时 `1-5 分钟` 都属于正常情况
* `4k` 高质量通常是最慢的

## 计费

* 目前仅按次付费
* 单次价格约 `0.03 USD`
* 折合大约 `2` 毛钱左右
* 价格会随 OpenAI 对中国风控和封号情况波动

## 支持模型

* `gpt-image-2`

<RequestExample>
  ```bash cURL theme={null} theme={null}
  curl --request POST \
    --url https://xcompute.us/v1/images/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "gpt-image-2",
      "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
      "n": 1,
      "size": "16:9",
      "resolution": "2k"
    }'
  ```
</RequestExample>

<ParamField body="model" type="string" required>
  固定填写 `gpt-image-2`。
</ParamField>

<ParamField body="prompt" type="string" required>
  图像描述文本。
</ParamField>

<ParamField body="size" type="string">
  图片比例，例如 `16:9`、`1:1`。
</ParamField>

## 调用方法

直接调用 `POST /v1/images/generations`，请求体里把 `model` 写成 `gpt-image-2` 即可。

```bash theme={null}
curl --request POST \
  --url https://xcompute.us/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
    "n": 1,
    "size": "16:9",
    "resolution": "2k"
  }'
```

<ResponseExample>
  ```json 200 theme={null} theme={null}
  {
    "code": 200,
    "data": {
      "id": "task_01JNXXXXXXXXXXXXXXXXXX",
      "status": "submitted",
      "progress": 0
    }
  }
  ```
</ResponseExample>