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: vtrix_edit_portrait
image_input string required
Input image URL. Supports JPG, JPEG, PNG formats.
prompt string
Prompt.
Default: empty string
width integer
Output image width.
Default: 1328
Range: 512 - 2048
height integer
Output image height.
Default: 1328
Range: 512 - 2048
gpen number
Face enhancement parameter. Higher value increases face clarity.
Default: 0.4
skin number
Skin beautification parameter. Higher value makes beautification effect more obvious.
Default: 0.3
skin_unifi number
Skin tone unification parameter. Higher value makes uniform skin tone and blemish removal effect more obvious.
Default: 0
gen_mode string
Reference mode.
Options: creative (prompt mode), reference (full reference mode), reference_char (character reference mode)
seed string
Random seed.
Default: -1
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 |