# 生成你的第一张图像

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

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

## 请求前

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

图像目前仅通过 API 使用。需要已有账户、足够余额、匹配的密钥分组及可用的上游容量。新用户注册与在线充值暂未开放。

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

## 1. 选择图像分组

本示例请在控制台中选择「渠道1 / image图片生成」创建网站 API 密钥。image-2 也提供价格不同的独立稳定分组，请明确所选分组，不要假设所有密钥的费率相同。

- 提交前，在模型目录中确认 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 请求的回执，也不代表某一特定模型的输出结果。