JIUFENG API

介绍

九凤开放 API —— OpenAI 兼容风格的异步生图网关。

九凤开放 API 让你用一把 API 密钥直接调用九凤的生图能力。接口是 OpenAI 兼容风格，但生成是异步的：

  1. 提交生图任务 → 立即拿到 task_id
  2. 轮询任务状态（或用 Webhook 回调）→ 终态成功后取结果图 URL

本站描述的是网关 api.jiufeng.ai/v1/* 的真实契约。端点、字段名、状态枚举均以此为准。

基础地址

https://api.jiufeng.ai

鉴权

所有请求用 Bearer 带上密钥（sk-jf-live- 开头）：

Authorization: Bearer sk-jf-live-YOUR_KEY

详见 鉴权。

端点一览

方法路径分组说明
POST/v1/images/generations模型相关 API提交生图任务（异步，返回 task_id）
GET/v1/tasks/{task_id}平台公共 API查询单个任务状态 / 结果
POST/v1/tasks/batch平台公共 API批量查询任务
POST<webhook>/callback模型相关 API终态回调（可选，由平台向你的地址推送）

异步工作流

提交 POST /v1/images/generations
        │
        ▼
   拿到 task_id
        │
        ├── 轮询 GET /v1/tasks/{task_id}  直到 completed / failed
        │
        └── 或：提交时带 webhook，平台仅在终态 POST <webhook>/callback（各一次）
        │
        ▼
   取 result.url（结果图，24h 内有效）

下一步

下一页

快速开始

本页目录