Help us improve
Share bugs, ideas, or general feedback.
From klingai-pack
Diagnoses and fixes Kling AI API errors like HTTP 400-503, task failures, and JWT issues with solutions for video generation troubleshooting.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin klingai-packHow this skill is triggered — by the user, by Claude, or both
Slash command
/klingai-pack:klingai-common-errorsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Complete error reference for the Kling AI API. Covers HTTP status codes, task-level failures, JWT issues, and generation-specific problems with tested solutions.
Documents Kling AI API pitfalls including duration as string, JWT headers, token refresh, polling timeouts, and temporary video URLs. Use for troubleshooting integrations.
Generates videos from text prompts or images, animates still images, and creates talking avatars from photos with audio using Kling AI models (VIDEO 3.0, Avatar 2.0, etc.). Handles multi-shot storyboards, character consistency, and prompt engineering.
Guides technical evaluation of code review feedback: read fully, restate for understanding, verify against codebase, respond with reasoning or pushback before implementing.
Share bugs, ideas, or general feedback.
Complete error reference for the Kling AI API. Covers HTTP status codes, task-level failures, JWT issues, and generation-specific problems with tested solutions.
| Code | Error | Cause | Solution |
|---|---|---|---|
400 | Bad Request | Invalid parameters, malformed JSON | Validate all required fields; check model_name is valid |
401 | Unauthorized | Invalid/expired JWT token | Regenerate JWT; verify AK/SK; check exp claim |
402 | Payment Required | Insufficient credits | Top up API resource pack or subscription |
403 | Forbidden | Content policy violation or API disabled | Review prompt against content policy; enable API access |
404 | Not Found | Invalid task_id or wrong endpoint | Verify task_id; check endpoint path spelling |
429 | Too Many Requests | Rate limit exceeded | Implement exponential backoff (see pattern below) |
500 | Internal Server Error | Kling platform issue | Retry after 30s; if persistent, check status page |
502 | Bad Gateway | Upstream service unavailable | Retry with backoff; typically transient |
503 | Service Unavailable | System maintenance | Wait and retry; check announcements |
When HTTP returns 200 but task_status is "failed":
task_status_msg | Cause | Solution |
|---|---|---|
| Content policy violation | Prompt contains restricted content | Remove violent, adult, or copyrighted references |
| Image quality too low | Source image is blurry or too small | Use image >= 300x300px, clear and sharp |
| Prompt too complex | Too many scene elements | Simplify to 1-2 subjects, clear action |
| Generation timeout | Internal processing exceeded limit | Retry; reduce duration from 10s to 5s |
| Invalid image format | Unsupported file type | Use JPG, PNG, or WebP |
| Mask dimension mismatch | Mask size differs from source | Ensure mask matches source image dimensions exactly |
401 on every request# WRONG — missing headers parameter
token = jwt.encode(payload, sk, algorithm="HS256")
# CORRECT — include explicit headers
token = jwt.encode(payload, sk, algorithm="HS256",
headers={"alg": "HS256", "typ": "JWT"})
# WRONG — token generated once at import time
TOKEN = generate_token()
# CORRECT — refresh before expiry
class TokenManager:
def __init__(self, ak, sk):
self.ak, self.sk = ak, sk
self._token = None
self._exp = 0
@property
def token(self):
if time.time() >= self._exp - 300: # 5 min buffer
payload = {"iss": self.ak, "exp": int(time.time()) + 1800,
"nbf": int(time.time()) - 5}
self._token = jwt.encode(payload, self.sk, algorithm="HS256",
headers={"alg": "HS256", "typ": "JWT"})
self._exp = int(time.time()) + 1800
return self._token
import time
import requests
def request_with_backoff(method, url, headers, json=None, max_retries=5):
"""Retry with exponential backoff on 429 and 5xx errors."""
for attempt in range(max_retries):
response = method(url, headers=headers, json=json)
if response.status_code == 429:
retry_after = int(response.headers.get("Retry-After", 2 ** attempt))
print(f"Rate limited. Retrying in {retry_after}s...")
time.sleep(retry_after)
continue
elif response.status_code >= 500:
wait = 2 ** attempt
print(f"Server error {response.status_code}. Retrying in {wait}s...")
time.sleep(wait)
continue
response.raise_for_status()
return response
raise RuntimeError(f"Max retries ({max_retries}) exceeded")
When a generation fails, check in order:
model_name matches catalog exactlyduration must be "5" or "10" (string, not int)image_tail, dynamic_masks, and camera_control are mutually exclusiveimport logging
logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger("kling")
def debug_request(method, url, headers, json=None):
"""Log request/response for debugging."""
logger.debug(f"→ {method.__name__.upper()} {url}")
logger.debug(f"→ Body: {json}")
r = method(url, headers=headers, json=json)
logger.debug(f"← Status: {r.status_code}")
logger.debug(f"← Body: {r.text[:500]}")
return r