跳到主要内容

图像 API

图像能力由模型和渠道决定。当前令牌可用模型请先查询 GET /v1/models；不要继续使用已经下架的 dall-e-2、dall-e-3 或 gpt-image-1 示例。

同步生成​

POST https://api.openfde.work/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

常见字段：

字段类型说明
modelstring当前令牌可见的图像模型。
promptstring生成提示词。
ninteger数量；是否支持由模型决定。
sizestring尺寸；由模型和渠道决定。
qualitystring质量档位；由模型和渠道决定。
response_formatstringurl 或 b64_json，是否支持由渠道决定。
curl https://api.openfde.work/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橙色小猫坐在阳光明媚的花园里",
    "n": 1,
    "size": "1024x1024"
  }'

同步编辑​

POST https://api.openfde.work/v1/images/edits
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

常见字段为 model、image、prompt、mask、n 和 size。不同模型可能只支持其中一部分，不能把 OpenAI 旧版参数直接套到所有图像渠道。

异步图像任务​

适合生成时间较长或需要后台轮询的场景：

POST /v1/images/generations/tasks
POST /v1/images/edits/tasks
GET  /v1/images/tasks/{task_id}
GET  /v1/images/tasks/{task_id}/status

异步请求不支持 stream；提交成功后保存任务 ID，并按返回状态轮询。任务状态和结果字段以响应为准。

参考环境样例​

2026-10-24 一个生产令牌返回的图像相关模型包括：

  • gpt-image-2
  • gemini-3-pro-image-preview
  • doubao-seedream-5-0-pro-260628

该列表会按令牌和渠道变化。未出现在 /v1/models 的旧版图像模型不要继续用于当前接入；若目标模型不在列表中，请求会失败。