1. 选择图像分组
本示例请在控制台中选择「渠道1 / image图片生成」创建网站 API 密钥。image-2 也提供价格不同的独立稳定分组,请明确所选分组,不要假设所有密钥的费率相同。
- 提交前,在模型目录中确认 image-2 的当前状态。
- 从 n: 1 开始。仅在模型文档明确支持时,再添加 size 或其他图像参数。
- 这里使用同步 Images API,与异步视频任务工作流分开。
2. 提交图像请求
在后端环境或终端中运行以下命令。它会将 JSON 响应保存为 image-response.json,便于检查返回的结果。
终端 · cURL
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 3. 读取并保存结果
使用结果前先检查 JSON。成功的图像响应可能在 data[0].url 提供图片地址,或在 data[0].b64_json 提供 Base64 图片数据。请按所选模型实际返回的格式处理。
如果返回 URL,就从该地址下载;如果返回 Base64,就解码为图像文件,并保留实际图像格式。不同模型未必返回相同文件类型。
请求超时时,请先核对记录中的结果再重新提交。仅凭客户端超时,不能断定生成尚未开始。
4. 同时核对用量与价格
目录中的图像模型按生成张数计费,实际费率由所选分组决定。切换模型或分组时,请重新查看当前详情。
网站中的蓝色小狗是用于展示的设计素材,并非此次 image-2 请求的回执,也不代表某一特定模型的输出结果。
下一步,先小步试试。
扩大工作流之前,先确认结果与当前用量。