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_base
image string required
Input image URL.
prompt string
Video generation prompt, length must be 1-2500 characters.
mode string
Generation mode.
Default: std
Options: std (standard), pro (professional)
duration string
Video duration (seconds).
Options: 5, 10
aspect_ratio string
Video aspect ratio.
Options: 16:9, 9:16, 1:1
cfg_scale number
Prompt relevance strength.
Range: 0 - 1
negative_prompt string
Negative prompt.
camera_control object
Camera motion control parameter.
seed integer
Random seed.
image_tail string
End frame image.
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 |