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_master
image string required
Input image URL or Base64 encoding (at least one of image or image_tail must be provided).
prompt string
Video generation prompt, max 2500 characters.
duration string required
Video duration.
Options: 5 or 10 seconds
mode string
Generation mode.
Default: std
Options: std (standard), pro (professional)
aspect_ratio string
Video aspect ratio.
Options: 16:9, 9:16, 1:1
camera_control object
Camera motion control parameters. If not specified, model will intelligently match based on input.
image_tail string
Tail frame image URL or Base64 encoding (at least one of image or image_tail must be provided).
static_mask string
Static mask.
dynamic_masks array
Dynamic mask list.
external_task_id string
External task ID.
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 |