🔌 qiai API v1

Enterprise AI image generation API · SDXL / AnimateDiff / Z-Image

⚠️ API access requires a paid subscription (Standard and above). View Plans

🔑 Authentication

All API requests must include an API Key using one of the following methods:

# Header method
Authorization: Bearer cfy-xx...xxxx

# OR
X-API-Key: cfy-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Generate your API Key on the Subscription page.

📤 Submit Generation Task

POST/api/v1/generate

Request Parameters

Parameter	Type	Required	Description
style	string	✅	Style: guofeng / anime / realistic / general / turbo / zanime / zimage
product_type	string		Product: static_image / batch_4 / batch_8 / animation_16f / animation_24f / animation_32f
prompt	string	✅	Positive prompt (Chinese or English supported)
negative_prompt	string		Negative prompt
width	int		Width (default: 768)
height	int		Height (default: 1152)
llm_enhance	bool		AI-powered prompt enhancement
webhook_url	string		Callback URL on completion

Example

curl -X POST https://your-server:7000/api/v1/generate \
  -H "Authorization: Bearer cfy-xx...xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "style": "guofeng",
    "product_type": "static_image",
    "prompt": "a warrior in red standing in bamboo forest holding a sword, ink wash painting style",
    "width": 768,
    "height": 1152,
    "llm_enhance": true,
    "webhook_url": "https://your-app.com/callback"
  }'

Response

{
  "ok": true,
  "order_id": "ORD-20260528-XXXXXX",
  "status": "pending",
  "product_type": "static_image",
  "style": "guofeng",
  "priority": 3
}

📊 Query Status

GET/api/v1/status/{order_id}

curl -H "Authorization: Bearer ***" \
  https://your-server:7000/api/v1/status/ORD-20260528-XXXXXX

📦 Subscription Tiers & Limits

Plan	Monthly Quota	Price	Batch	Animation	Styles
Free	20	$0	—	—	Turbo only
Standard	300	$6	3/batch	—	All styles
Pro	800	$13	8/batch	✅	All styles
Mega	2000	$30	12/batch	✅	All styles

⚡ Priority Queue

Mega (4) > Pro (3) > Standard (2) > Free (0). Higher-priority orders are processed first.

🔔 Webhook

On task completion, a POST request is sent to your webhook_url:

{
  "order_id": "ORD-20260528-XXXXXX",
  "status": "completed",
  "output_urls": ["https://.../output1.png", "https://.../output2.png"]
}

📧 Support: 37405912@qq.com