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