Create business photo or avatar from face image

This API function generates a custom avatar based on a single input image, ideal for creating high-quality avatars from a provided reference. Users can customize the avatar's dimensions, background, and style to suit various use cases.

Let's use this image as input:

When creating images, there are several model types available. However, these two are preferred for optimal results:

• see-dream-4.5

• qwen

• gemini-3-pro-image-preview

• flux2-klein9b

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "width": 1024,
    "height": 1024,
    "background": {
        "generate": {
            "description": "Woman in a beige pantsuit, arms in pockets, looking professional, standing near a bookshelf. Outfit:  beige linen pantsuit and white blouse.",
            "adapter_type": "face",
            "model_type": "see-dream-4.5",
            "avatar_generation_type": "regular"
        }
    }
}

see-dream-4.5

qwen

gemini-3-pro-image-preview

flux2-klein9b

Also face swap can be used to ensure the face will be as close to source face as possible.

It can be done by specifying avatar_generation_type = "accurate"

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "width": 1024,
    "height": 1024,
    "background": {
        "generate": {
            "description": " a woman sitting behind a desk in a modern office environment. her smiling face is seen from behind her computer screen, with only the top of her head and a portion of her shoulders visible. The office space around her is bright and airy, illuminated by soft, natural light streaming in from large windows.",
            "adapter_type": "face",
            "model_type": "google-gemini-image-flash",
            "avatar_generation_type": "accurate"
        }
    }
}

Description of older models

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "width": 1024,
    "height": 1024,
    "background": {
        "generate": {
            "description": " a woman sitting behind a desk in a modern office environment. her smiling face is seen from behind her computer screen, with only the top of her head and a portion of her shoulders visible. The office space around her is bright and airy, illuminated by soft, natural light streaming in from large windows.",
            "adapter_type": "face",
            "face_id": true
        }
    }
}

Parameter Breakdown:

• url: URL of the input image that will serve as the base for avatar generation.

• width and height: Dimensions of the output avatar image, specified in pixels. Here, the output will be a 1024x1024 square.

• background:

  • generate: Details for the AI-generated image.

    • description: Text description

    • adapter_type: it has to be "face" for avatar generation

    • face_id: if true it turns on algorithm that changes hair, etc.