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