API Documentation

Integrate WangPai AI generation into your own applications

Rate Limits

60 requests/min for Pro, 10/min for Free

Authentication

Bearer token via API key in header

Webhooks

Async callbacks for generation completion

Endpoints

POST/api/v1/generateCreate a new generation task

GET/api/v1/generation/:idGet generation status and result

GET/api/v1/generationsList all generation history

GET/api/v1/user/creditsQuery remaining Flight Coins

POST/api/v1/uploadUpload reference image

Quick Start

import requests

API_KEY = "wp_sk_xxxxxxxxxxxxxxxx"

response = requests.post(
    "https://api.wangpai.ai/v1/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "type": "video",
        "model": "wp_cinematic_video",
        "prompt": "A cinematic sunset over futuristic city",
        "ratio": "16:9",
        "duration": "5s",
        "quality": "hd"
    }
)

print(response.json())