Authentication
authorization string required
All APIs require authentication via Bearer Token.
Get API Key:
Visit API Key Management Page to get your API Key
Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEY
Parameters
model string required
Model ID to use for the request.
Value: ultra_i2v_1_5
image string required
Input image URL or Base64 encoding.
image_tail string
Tail frame image URL or Base64 encoding.
prompt string
Video generation prompt, length must not exceed 2500 characters.
duration string
Video duration.
Options: 5, 10
aspect_ratio string
Video aspect ratio.
Options: 16:9, 9:16, 1:1
cfg_scale number
Motion intensity/CFG scaling.
Default: 0.5
seed integer
Random seed.
negative_prompt string
Negative prompt.
mode string
Generation mode.
Default: std
Options: std, pro
callback string
Callback URL.
Error Codes
| Code | Description |
|---|---|
| 401 | API key is missing or invalid |
| 403 | Insufficient balance or permission denied |
| 429 | Rate limit exceeded |
| 500 | Internal server error |