Skip to main content

Dzine - Image Variator

Transform and stylize existing images using Dzine's advanced image-to-image AI technology. Maintain core elements while applying new styles, adjusting structure, preserving colors, and matching faces for creative image variations.

Endpoint​

Request Headers​

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters​

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_VARIATOR
modelstringYesAI model identifier. Must be dzine
promptObjectobjectYesConfiguration object containing all transformation parameters

Prompt Object Parameters​

ParameterTypeRequiredDescriptionDefault
promptstringYesText description guiding the transformation-
imageUrlstringYesAsset path to the source image to transform. Example: development/images/2025_11_05_22_13_08_115_547133.webp-
style_codestringYesStyle code from Dzine's style library-
style_base_modelstringYesBase model from Dzine's style library: "S" only (Model X not supported for image variator)-
qualitystringYesImage quality mode: "STANDARD" only-
nnumberYesNumber of variations to generate (1-4)-
style_intensitynumberNoStrength of style applied (0.0-1.0 in 0.1 increments)0
structure_matchnumberNoStrength of maintaining input image structure (0.0-1.0 in 0.1 increments)-
color_matchbooleanNoPreserve original color tones in generated imagefalse
face_matchbooleanNoPreserve facial identities from source imagefalse
seednumberNoRandom seed for reproducibility (1-2147483647)Random
output_formatstringNoOutput format: "webp" or "jpeg""jpeg"

Image Requirements​

  • Maximum Size: 10 MB
  • Formats: JPG, PNG, WebP supported as input

Style Codes​

Dzine offers 200+ curated styles based on two foundational models:

  • Model S: Standard quality generation
  • Model X: Extended quality generation

Use the Get Dzine Style List API to retrieve all available style codes.

Get Dzine Style List API​

Before transforming images, you need to retrieve available style codes using this endpoint.

Endpoint​

Request Headers​

FieldValue
API-KEY<api-key>

Response Format​

{
"styleList": [
{
"name": "No Style v2",
"base_model": "S",
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"cover_url": "https://static.stylar.ai/stylar_admin/common/style_avatar/6ce8b5158b63c56d32cd8305a73ecab8/1721212364855681_11_312.jpg",
"style_intensity": {
"img2img": 0,
"txt2img": 0
}
},
{
"name": "Watercolor",
"base_model": "S",
"style_code": "Style-b2c3d4e5-f6g7-8901-bcde-fg2345678901",
"cover_url": "https://static.stylar.ai/.../watercolor_style.jpg",
"style_intensity": {
"img2img": 0.9,
"txt2img": 0.8
}
}
],
"total": 208
}

Style List Response Fields​

FieldTypeDescription
namestringHuman-readable style name
base_modelstringModel type: "S" (Standard) or "X" (Extended)
style_codestringUnique style identifier to use in transformation requests
cover_urlstringPreview image URL showing the style
style_intensity.txt2imgnumberRecommended intensity for text-to-image (0-1)
style_intensity.img2imgnumberRecommended intensity for image-to-image (0-1)

Example Request​

curl --location 'https://api.1min.ai/api/dzine/styles' \
--header 'API-KEY: <api-key>'

Interactive Playground​

API Playground

https://api.1min.ai/api/dzine/styles

Generated cURL Command:

curl -X GET "https://api.1min.ai/api/dzine/styles" \
-H "API-KEY: <your-api-key>"

Code Examples​

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_VARIATOR",
"model": "dzine",
"promptObject": {
"prompt": "Transform into a vibrant watercolor painting style",
"imageUrl": "development/images/2025_11_05_22_13_08_115_547133.webp",
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"style_base_model": "S",
"n": 2,
"style_intensity": 0.9,
"structure_match": 0.7,
"quality": "STANDARD",
"output_format": "jpeg"
}
}'

Interactive Playground​

API Playground

https://api.1min.ai/api/features
Describe the desired transformation
Asset path to the source image
Style code from Dzine style library
Base model from Dzine style library (only Model S supported)
Number of image variations to generate (1-4)
Strength of style applied (0.0-1.0)
Preserve input image structure (0.0-1.0)
Image generation quality mode (only STANDARD supported)
Preserve original color tones
Preserve facial identities
Output image format
Random seed for reproducibility (1-2147483647)

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"type": "IMAGE_VARIATOR",
"model": "dzine",
"promptObject": {
"prompt": "Transform into a vibrant watercolor painting style",
"imageUrl": "development/images/2025_11_05_22_13_08_115_547133.webp",
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"style_base_model": "S",
"n": 2,
"style_intensity": 0.9,
"structure_match": 0.7,
"quality": "STANDARD",
"output_format": "jpeg"
}
}'

Response Format​

{
"aiRecord": {
"uuid": "d7eb5c5f-fe33-4f0e-b25b-901c90adabed",
"userId": "f944dd01-da40-405c-b698-708269eb9664",
"teamId": "7d530bad-357c-4f6e-b627-16f043c9a16b",
"teamUser": {
"teamId": "7d530bad-357c-4f6e-b627-16f043c9a16b",
"userId": "f944dd01-da40-405c-b698-708269eb9664",
"userName": "test",
"userAvatar": null,
"status": "ACTIVE",
"role": "ADMIN",
"creditLimit": 100000000,
"usedCredit": 7620000,
"createdAt": "2025-10-31T06:24:14.102Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-11-05T15:54:15.506Z",
"updatedBy": "SYSTEM"
},
"model": "dzine",
"type": "IMAGE_VARIATOR",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-11-05T15:54:51.602Z",
"aiRecordDetail": {
"promptObject": {
"n": 2,
"seed": 123,
"prompt": "Transform into a vibrant watercolor painting style",
"quality": "STANDARD",
"imageUrl": "development/images/2025_11_05_22_13_08_115_547133.webp",
"face_match": true,
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"color_match": true,
"output_format": "jpeg",
"structure_match": 0.7,
"style_intensity": 0.9,
"style_base_model": "S"
},
"resultObject": [
"development/images/2025_11_05_22_54_51_955_232962.jpeg"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_11_05_22_54_51_955_232962.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251105%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251105T155456Z&X-Amz-Expires=604800&X-Amz-Signature=720fc913370fb919c6f0dd8e4605eaf6f69cd6aa20256f5b4d2e5af80a696398&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases​

  • Style Transfer: Apply artistic styles to photographs and images
  • Photo Enhancement: Transform photos with different aesthetic treatments
  • Design Exploration: Generate multiple style variations from a single source
  • Brand Consistency: Apply consistent visual styles across image collections
  • Creative Remixing: Reimagine existing artwork in new styles while preserving structure

Tips for Best Results​

  1. Prompt Engineering:

    • Describe the desired transformation or aesthetic
    • Include style keywords (watercolor, oil painting, anime, photorealistic)
    • Mention lighting, mood, and atmosphere changes
  2. Preservation Controls:

    • Enable color_match to keep original color palette
    • Enable face_match for portraits to maintain identity
    • Combine with high structure_match for minimal changes
    • Disable both for maximum creative freedom
    • Generate multiple variations (n=2-4) to explore options