图像生成

从提示词生成图像，并在需要时查询原任务。

不同图像模型使用不同的协议和尺寸参数。先在模型详情中确认模型支持 OpenAI Images，还是 Gemini 图像协议。以下是 OpenAI Images 的最小接入流程。

提交生成请求

POST/v1/images/generations

将 OCEANWAY_IMAGE_MODEL 设为支持下面规格的已发布图像模型。该请求会产生实际模型用量。

curl --fail-with-body \
  --dump-header oceanway-image.headers \
  https://console.oceanway.tech/v1/images/generations \
  -H "Authorization: Bearer $OCEANWAY_API_KEY" \
  -H "Content-Type: application/json" \
  --data "{\"model\":\"$OCEANWAY_IMAGE_MODEL\",\"prompt\":\"宁静的蓝色海湾，清晨柔和的光线，电影摄影。\",\"size\":\"1024x1024\",\"n\":1}"

常用参数

参数	含义	使用说明
model	准确模型 ID	从模型详情复制
prompt	图像描述	使用清晰的主体、风格与构图描述
size	目标图像尺寸	例如 1024x1024，以模型支持规格为准
n	输出数量	从单张开始，数量上限因模型而异
response_format	返回格式	仅在模型支持时使用 url 或 b64_json

不要将 OpenAI 的 size 与 Gemini 的 imageSize、aspectRatio 混用。请求尺寸与最终输出尺寸应分别检查。

获取结果

同步完成时，结果通常位于响应的 data 中，例如 data[].url 或 data[].b64_json。异步接收时，保存响应中的任务 ID，并按该模型的任务协议读取原任务。

curl --fail-with-body \
  "https://console.oceanway.tech/v1/images/$OCEANWAY_IMAGE_TASK_ID" \
  -H "Authorization: Bearer $OCEANWAY_API_KEY"

当响应给出任务输出内容路径时，可以使用原 Key 下载对应文件：

curl --fail-with-body \
  "https://console.oceanway.tech/v1/images/$OCEANWAY_IMAGE_TASK_ID/outputs/0/content" \
  -H "Authorization: Bearer $OCEANWAY_API_KEY" \
  --output image-output.bin

按实际内容类型保存扩展名。私密结果链接不要公开分享或写入公开日志；需要长期使用的结果应及时保存到你自己的存储中。

图像编辑与 Gemini 图像

图像编辑使用 /v1/images/edits，请求格式、参考图和参数按模型详情中的原生示例设置。Gemini 图像生成使用对应模型的 generateContent 接口及图像输出配置。

这些能力取决于具体模型。不要仅修改 model 就复用其他协议的图像请求。

请求中断时

先检查原任务和控制台媒体任务。已拿到任务 ID 后，持续查询该 ID；不要通过再次提交生成来刷新状态。文件下载失败时，重新读取原输出即可。见 任务与结果。