可灵 Kling 4.0 使用教程：提示词写法与 API 示例

import json, os, sys, time, uuid
from decimal import Decimal

import requests

API = "https://api.makernice.com/v1"
H = {"Authorization": f"Bearer {os.environ['MAKERNICE_API_KEY']}"}

# Usage: python kling4.py t2v.json  (any request body from this guide)
with open(sys.argv[1]) as f:
    job = json.load(f)

# 1. Quote: free, the exact amount is locked for 12 minutes
r = requests.post(f"{API}/generations/quote", json=job, headers=H, timeout=30)
if not r.ok:
    sys.exit(f"quote {r.status_code}: {r.text}")
quote = r.json()
print("Quoted", Decimal(quote["amount"]).scaleb(-6), "US dollars")

# 2. Create with the quote id; a retry with the same Idempotency-Key is not charged twice
r = requests.post(f"{API}/generations", json={"quote_id": quote["id"], "input": job},
                  headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
if not r.ok:
    sys.exit(f"create {r.status_code}: {r.text}")
gen = r.json()
print("Generation", gen["id"])

# 3. Poll until the generation ends (give up after 30 minutes)
deadline = time.monotonic() + 30 * 60
while gen["status"] not in ("succeeded", "failed", "canceled"):
    if time.monotonic() > deadline:
        sys.exit(f"{gen['id']} is still {gen['status']}, poll it again later")
    time.sleep(5)
    r = requests.get(f"{API}/generations/{gen['id']}", headers=H, timeout=15)
    r.raise_for_status()
    gen = r.json()
if gen["status"] != "succeeded":
    sys.exit(f"{gen['status']}: {gen.get('error')}")

# 4. Download: the API answers with a redirect to the file
video = requests.get(f"{API}/generations/{gen['id']}/outputs/0", headers=H, timeout=120)
video.raise_for_status()
with open("kling4.mp4", "wb") as f:
    f.write(video.content)
print("Saved kling4.mp4")

{
  "model": "kling-4.0",
  "mode": "t2v",
  "prompt": "A lighthouse keeper climbs a spiral staircase carrying a lantern, slow upward tracking shot, wind howling outside and footsteps echoing on the iron steps",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "21:9"
}

{
  "model": "kling-4.0",
  "mode": "i2v",
  "prompt": "The cat on the windowsill turns its head toward the street and yawns, static close-up, soft rain tapping on the glass",
  "image_url": "https://example.com/cat-on-windowsill.jpg",
  "duration": 5
}

{
  "model": "kling-4.0",
  "mode": "flf",
  "prompt": "Morning turns to night as the market stalls light up one by one, locked-off wide shot, crowd chatter growing louder",
  "image_url": "https://example.com/market-morning.jpg",
  "last_image_url": "https://example.com/market-night.jpg",
  "duration": 8,
  "resolution": "720p"
}

{
  "model": "kling-4.0",
  "mode": "r2v",
  "prompt": "The woman from the first reference image walks the dog from the second reference image along a beach at sunset, tracking shot from the side, waves and distant gulls",
  "reference_images": [
    "https://example.com/woman.jpg",
    "https://example.com/dog.jpg"
  ],
  "duration": 6,
  "aspect_ratio": "16:9"
}