Skip to main content

Dzine - Image Generator

Professional AI image generation with Dzine's advanced text-to-image models. Dzine provides high-quality image generation with extensive style options, face matching capabilities, and flexible output configurations for creative workflows.

Endpoint​

Request Headers​

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

Parameters​

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_GENERATOR
modelstringYesAI model identifier. Must be dzine
promptObjectobjectYesConfiguration object containing all generation parameters

Prompt Object Parameters​

ParameterTypeRequiredDescriptionDefault
promptstringYesText description of the image to generate-
style_codestringYesStyle code from Dzine's style library-
style_base_modelstringYesBase model from Dzine's style library: "S" or "X"-
qualitystringYesImage quality mode: "STANDARD" or "HIGH"-
nnumberYesNumber of images to generate (1-4)-
output_formatstringYesOutput format: "webp" or "jpeg"-
sizestringNoImage dimensions in format "WIDTHxHEIGHT" (128-1536 pixels)"1024x1024"
style_intensitynumberNoStrength of style applied (0.0-1.0 in 0.1 increments)0
seednumberNoRandom seed for reproducibility (1-2147483647)Random
face_matchbooleanNoEnable face matching from reference imagefalse
face_match_imagestringNoAsset path to reference face image (required if face_match is true). Example: development/images/reference_face.jpg-

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 generating 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": "Anime",
"base_model": "S",
"style_code": "Style-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cover_url": "https://static.stylar.ai/.../anime_style.jpg",
"style_intensity": {
"img2img": 0.8,
"txt2img": 0.9
}
}
],
"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 generation 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>"

Image Generation Code Examples​

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "dzine",
"promptObject": {
"prompt": "A serene mountain landscape at sunset with vibrant autumn colors",
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"style_base_model": "S",
"size": "1024x1024",
"n": 1,
"style_intensity": 0.8,
"quality": "HIGH",
"output_format": "webp"
}
}'

Interactive Playground​

API Playground

https://api.1min.ai/api/features
Describe the image you want to generate
Style code from Dzine style library
Base model from Dzine style library
Output image dimensions
Number of images to generate (1-4)
Strength of style applied (0.0-1.0)
Image generation quality mode
Output image format
Enable face matching from reference image
Asset path to reference face image
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_GENERATOR",
"model": "dzine",
"promptObject": {
"prompt": "A serene mountain landscape at sunset with vibrant autumn colors",
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"style_base_model": "S",
"size": "1024x1024",
"n": 1,
"style_intensity": 0.8,
"quality": "HIGH",
"output_format": "webp"
}
}'

Response Format​

{
"aiRecord": {
"uuid": "c0c00d36-2769-48e4-9033-7db054d48623",
"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": 5970000,
"createdAt": "2025-10-31T06:24:14.102Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-11-03T13:28:38.861Z",
"updatedBy": "SYSTEM"
},
"model": "dzine",
"type": "IMAGE_GENERATOR",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-11-05T15:13:06.598Z",
"aiRecordDetail": {
"promptObject": {
"n": 1,
"size": "1024x1024",
"prompt": "A serene mountain landscape at sunset with vibrant autumn colors",
"quality": "HIGH",
"style_code": "Style-7feccf2b-f2ad-43a6-89cb-354fb5d928d2",
"output_format": "webp",
"style_intensity": 0.8,
"style_base_model": "S"
},
"resultObject": [
"development/images/2025_11_05_22_13_08_115_547133.webp"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_11_05_22_13_08_115_547133.webp?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=20251105T151312Z&X-Amz-Expires=604800&X-Amz-Signature=07c8f92f29a6b1dcec19da3a145a391e9e9f5d48b7a9c2ee117634838c854f75&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases​

  • Creative Design: Generate unique artwork and visual concepts with diverse styles
  • Marketing Materials: Create branded visuals with consistent style application
  • Character Design: Generate characters with face matching for consistent identity
  • Concept Art: Rapid prototyping of visual ideas across multiple styles
  • Social Media Content: Produce engaging visuals optimized for various platforms

Tips for Best Results​

  1. Prompt Engineering:

    • Be descriptive and specific
    • Include details about composition, lighting, and mood
    • Mention key elements you want to see in the image
  2. Style Selection:

    • Browse Dzine's 200+ styles to find the perfect aesthetic
    • Use style_intensity to control how strongly the style is applied
    • Higher intensity (0.8-1.0) for strong stylization
    • Lower intensity (0.2-0.4) for subtle style hints
  3. Quality vs Speed:

    • Use STANDARD quality for faster iterations
    • Use HIGH quality for final production images
    • Generate multiple images (n=2-4) to get variety
  4. Face Matching:

    • Use clear, well-lit reference images
    • Ensure face proportion is less than 80% of image
    • Works best with frontal or slightly angled face poses