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_KEYParameters
model string required
Model ID to use for the request.
Value: ultra_i2v_2_1
image string required
Input image. Supports URL or Base64 format.
prompt string
Video generation prompt, maximum 2500 characters.
duration string required
Video duration.
Options: 5 (5 seconds), 10 (10 seconds)
mode string
Generation mode.
Default: std
Options: std (standard), pro (professional)
aspect_ratio string
Video aspect ratio.
Options: 16:9 (landscape), 9:16 (portrait), 1:1 (square)
camera_control object
Camera motion control parameter.
image_tail string
End frame image. Supports URL or Base64 format.
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 |