快速开始

1. 拿到 API 密钥

登录九凤，打开 控制台 → API 密钥 页（新标签打开），点「创建密钥」。完整密钥 只显示这一次，请立刻复制保存（sk-jf-live- 开头）。

下文示例统一用占位符 sk-jf-live-YOUR_KEY，替换成你自己的密钥即可。

2. 提交一个生图任务

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": "一只在霓虹城市奔跑的柴犬，赛博朋克风",
    "n": 1,
    "size": "16:9",
    "resolution": "1K"
  }'

立即返回一个 task_id（生成是异步的）：

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

不想切走页面？贴上你的密钥，直接在这里试跑：

Try it 在线调用

贴 Key 自测

免 Key已登录？去控制台 Playground 免 Key 试跑用你的账号直接跑、无需 API 密钥 —— 体验最快。→

或

验证你自己的 API 集成

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

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

API 密钥

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

在控制台获取密钥 →

提示词

宽高比

清晰度

先贴上你的 API 密钥。

结果

生成结果会出现在这里。

3. 轮询结果

用上一步的 task_id 查任务：

curl https://api.jiufeng.ai/v1/tasks/task_01M0CGM9MRSMD6R6PPNQWXQZ77 \
  -H "Authorization: Bearer sk-jf-live-YOUR_KEY"

status 到达 completed 时，结果图在 data.result.url（数组）：

{
  "code": 200,
  "data": {
    "id": "task_01M0CGM9MRSMD6R6PPNQWXQZ77",
    "status": "completed",
    "progress": "100%",
    "result": {
      "url": ["https://token-img.jiufeng.ai/f/image/xxx_0.png"],
      "expires_at": 1785163216,
      "image_ids": ["img_01M0..."]
    }
  }
}

status 的真值是 pending / processing / completed / failed（不是 queued / success）。结果图 URL 完成后 24 小时过期，请尽快下载 / 转存。

4.（可选）改用 Webhook，别一直轮询

提交时带上 webhook 字段，平台会在任务进入终态（completed / failed）时 POST 到 <webhook>/callback，省掉轮询。详见 Webhook 回调。

轮询建议

指数退避：首次约 1s，逐步拉长到几秒一次，别每 100ms 打一次。详见查询任务。

1. 拿到 API 密钥

2. 提交一个生图任务

3. 轮询结果

4.（可选）改用 Webhook，别一直轮询

轮询建议

本页目录