JIUFENG API

Introduction

Jiufeng Open API — an OpenAI-compatible, asynchronous image generation gateway.

Jiufeng Open API lets you tap into Jiufeng's image generation with a single API key. The interface follows the OpenAI-compatible style, but generation is asynchronous:

  1. Submit a generation task → get a task_id immediately
  2. Poll the task status (or use a webhook) → fetch the result image URL once it completes

This site documents the real contract of the api.jiufeng.ai/v1/* gateway. Endpoints, field names, and status enums here are authoritative.

Base URL

https://api.jiufeng.ai

Authentication

Send your key (prefixed sk-jf-live-) as a Bearer token:

Authorization: Bearer sk-jf-live-YOUR_KEY

See Authentication.

Endpoints

MethodPathGroupDescription
POST/v1/images/generationsModel APIsSubmit a generation task (async, returns task_id)
GET/v1/tasks/{task_id}Platform APIsQuery a single task's status / result
POST/v1/tasks/batchPlatform APIsQuery multiple tasks at once
POST<webhook>/callbackModel APIsTerminal-state callback (optional; pushed by the platform)

Async workflow

Submit  POST /v1/images/generations
        │
        ▼
   receive task_id
        │
        ├── Poll  GET /v1/tasks/{task_id}  until completed / failed
        │
        └── or: pass a webhook on submit; the platform POSTs <webhook>/callback
        │        only on terminal states (once each)
        ▼
   read result.url (result image, valid for 24h)

Next steps

Next

Quickstart

On this page