JIUFENG API

生成图片

POST /v1/images/generations —— 提交异步生图任务。

POST /v1/images/generations

提交一个生图任务，立即返回 task_id（生成是异步的）。随后用 查询任务 轮询，或用 Webhook 接收终态回调。

图生图 / 参考图也走这个端点：通过 image_urls 传参考图即可，无需单独的编辑接口。

Try it 在线调用
贴 Key 自测
免 Key已登录？去控制台 Playground 免 Key 试跑用你的账号直接跑、无需 API 密钥 —— 体验最快。→
或
验证你自己的 API 集成

贴上你自己的 sk- 密钥，验证公开 API 接入是否打通。

⚠ 会用你的密钥发起真实调用、消耗额度。

🔒 密钥只用于本次调用、不会保存，刷新页面即清除。

在控制台获取密钥 →
先贴上你的 API 密钥。
结果
生成结果会出现在这里。

请求参数

字段类型必填说明
promptstring是提示词
modelstring否当前为 gpt-image-2（更多模型即将推出）
sizestring否宽高比（非像素），如 16:9 / 1:1 / 9:16
resolutionstring否清晰度档：1K / 2K / 4K
ninteger否生成张数，默认 1
image_urlsstring[]否参考图 / 图生图源图 URL，最多 15 张
webhookstring否回调 base 地址；平台仅在终态 POST 到 <webhook>/callback（见 Webhook）
languagestring否错误文案语言（zh / en / ko / ja）

字段名以九凤网关口径为准：清晰度是 resolution（不是 upscale），参考图是 image_urls。size 是宽高比，不是像素尺寸。

示例

curl
curl https://api.jiufeng.ai/v1/images/generations \
  -H "Authorization: Bearer sk-jf-live-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "参考这张图的构图，换成雪山背景",
    "size": "1:1",
    "resolution": "2K",
    "image_urls": ["https://your-cdn.example.com/ref1.png"]
  }'
Python
import requests
 
resp = requests.post(
    "https://api.jiufeng.ai/v1/images/generations",
    headers={"Authorization": "Bearer sk-jf-live-YOUR_KEY"},
    json={
        "model": "gpt-image-2",
        "prompt": "一只在霓虹城市奔跑的柴犬，赛博朋克风",
        "size": "16:9",
        "resolution": "1K",
        "n": 1,
    },
)
task_id = resp.json()["data"][0]["task_id"]
print(task_id)
JavaScript
const resp = await fetch("https://api.jiufeng.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-jf-live-YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "一只在霓虹城市奔跑的柴犬，赛博朋克风",
    size: "16:9",
    resolution: "1K",
    n: 1,
  }),
});
const { data } = await resp.json();
const taskId = data[0].task_id;

响应

{
  "code": 200,
  "data": [
    { "status": "submitted", "task_id": "task_01M0CGM9MRSMD6R6PPNQWXQZ77" }
  ]
}

拿到 task_id 后：

上一页

鉴权

下一页

Webhook 回调

本页目录