# 生成你的第一张图像

选择图像模型，提交提示词，保存生成结果。

<a id="overview"></a>

## 请求前

图像通过 API 生成。本指南使用已配置的 image-2 路由，从一张图像和一段简明的提示词开始。

图像生成通过 API 使用。注册已开放；请检查钱包余额与当前充值选项，再选择匹配的密钥分组，并确认上游容量。

<a id="prepare-key"></a>

## 1. 选择图像分组

本示例请在控制台选择「经济方案｜Image（image图片生成）」创建本站 API 密钥。image-2 也提供价格不同的「标准方案｜Image（image图片生成稳定）」，请明确所选分组，不要假设所有密钥费率相同。

- 提交前，在模型目录中确认 image-2 的当前状态。
- 从 n: 1 开始。仅在模型文档明确支持时，再添加 size 或其他图像参数。
- 这里使用同步 Images API，与异步视频任务工作流分开。

<a id="generate-image"></a>

## 2. 提交图像请求

在后端环境或终端中运行以下命令。它会将 JSON 响应保存为 image-response.json，便于检查返回的结果。

```
export OHGROK_API_KEY='YOUR_API_KEY'

curl --fail-with-body --silent --show-error \
  'https://api.ohgrok.com/v1/images/generations' \
  -H "Authorization: Bearer $OHGROK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "image-2",
    "prompt": "A blue inflatable puppy on a peach studio set, soft natural shadows",
    "n": 1
  }' \
  -o image-response.json
```

<a id="save-image"></a>

## 3. 读取并保存结果

使用结果前先检查 JSON。成功的图像响应可能在 data[0].url 提供图片地址，或在 data[0].b64_json 提供 Base64 图片数据。请按所选模型实际返回的格式处理。

如果返回 URL，就从该地址下载；如果返回 Base64，就解码为图像文件，并保留实际图像格式。不同模型未必返回相同文件类型。

请求超时时，请先核对记录中的结果再重新提交。仅凭客户端超时，不能断定生成尚未开始。

<a id="understand-billing"></a>

## 4. 同时核对用量与价格

image-2 按生成张数计费，部分 Grok 与 GPT Image 路由则按请求计费，图片张数不总是计费次数。估算批量用量前，核对准确模型、分组与计费单位；展示价格已包含一次分组倍率。

网站中的蓝色小狗是用于展示的设计素材，并非此次 image-2 请求的回执，也不代表某一特定模型的输出结果。

