Synthesis AI for ID Verification

Overview

Smartphones, PCs, and even financial, legal, government, healthcare and other institutions are increasingly using facial recognition for identity verification. But recent events have highlighted the strong bias in existing datasets — so much so, that according to Gartner, by 2022, more than 95% of RFPs for “will contain clear requirements regarding minimizing demographic bias” (2020 Gartner Market Guide for Identity Proofing and Affirmation).

Synthesis AI features over 40,000 unique identities across a broad spectrum of skin tones and ages. We also feature glasses, face masks, hats, headphones, facial hair, and infinite lighting and camera controls -- we can help your facial recognition models meet today's requirements.

Our API provides the ability to mimic indoor and outdoor environments so you can quickly test and iterate machine learning models across a broader set of settings and situations without spinning up a massive data collection effort. This includes granular control of mouth opening, gaze angle, head pose, accessories, gestures, lighting environments, camera systems (e.g. multi-camera modules), and more.

This document aims to provide copy-and-paste input examples to our API that serve many of the facial re-identification scenarios, including:

  • Skin Tone and Age
  • Camera Placement
  • Occlusion
  • Hair and Facial Hair
  • Illumination


Workflow

The standard workflow for the Synthesis AI Face API is:

  1. Register Account, Download & Setup CLI
  2. Select Identities for the Face API with the Identities API
  3. Create Face API job with input JSON
  4. Download job output with CLI
  5. Parse outputs into your ML pipeline

Hello Re-ID World

Re-identification is one of the most challenging tasks in computer vision, and the most important to remove all forms of bias. Bias shows up in many forms from human demographics, to camera angle and human pose, and environmental factors. Confounds also create issues for re-identification models, like changing hair, facial hair growth throughout the day, hats, facial masks, and headphones.

To make it easy to get these replicate all of these potential video conference settings, the JSON provided contains the following features:

  • 4 identities with 1 renders per identitiy (selected via Identities API)
  • Camera placement similar to both desktop and mobile phones
  • Dark & light indoor and outdoor environments
  • Sunglasses (20% of images)
  • Headwear (20% of images)
  • Head Turn: head turn upwards (25), 20% of images
  • Facial Hair (20% of images)
  • Variety of clothing

To process the outputs more easily, we provide a face_api_dataset library in Python, and output documentation.

Quickstart JSON for ID Verification

{
  "humans": [
    {
      "identities": {
        "ids": [
          1
        ],
        "renders_per_identity": 1
      },
      "facial_attributes": {
        "hair": [
          {
            "style": [
              "male_hair_long_messy_1"
            ],
            "sex_matched_only": true,
            "ethnicity_matched_only": true,
            "relative_length": {
              "type": "range",
              "values": {
                "min": 0.5,
                "max": 0.8
              }
            },
            "relative_density": {
              "type": "range",
              "values": {
                "min": 0.5,
                "max": 1
              }
            },
            "color_seed": {
              "type": "range",
              "values": {
                "min": 0,
                "max": 1
              }
            },
            "percent": 100
          }
        ]
      },
      "body": [
        {
          "enabled": true,
          "match_id_body_type": true,
          "percent": 100
        }
      ],
      "environment": {
        "hdri": {
          "name": [
            "abandoned_factory_canteen_01",
            "abandoned_factory_canteen_02",
            "abandoned_games_room_01",
            "abandoned_games_room_02",
            "abandoned_hall_01",
            "abandoned_workshop",
            "adams_place_bridge",
            "aerodynamics_workshop",
            "aft_lounge",
            "aircraft_workshop_01",
            "anniversary_lounge",
            "art_studio",
            "artist_workshop",
            "auto_service",
            "autoshop_01",
            "ballroom",
            "bathroom",
            "blender_institute",
            "blinds",
            "boiler_room",
            "bush_restaurant",
            "cabin",
            "canada_montreal_loft_max",
            "canada_montreal_nad_cafeteria",
            "canada_montreal_nad_photorealism",
            "canada_montreal_office",
            "canada_montreal_pierre_bathroom",
            "canada_montreal_pierre_kitchen",
            "carpentry_shop_01",
            "carpentry_shop_02",
            "cayley_interior",
            "childrens_bedroom_1",
            "childrens_bedroom_2",
            "childrens_hospital",
            "cinema_hall",
            "cinema_lobby",
            "circus_arena",
            "colorful_studio",
            "combination_room",
            "concrete_tunnel",
            "concrete_tunnel_02",
            "courtyard_night",
            "dance_studio",
            "de_balie",
            "dresden_station_night",
            "empty_warehouse_01",
            "en_suite",
            "entrance_hall",
            "fireplace",
            "floral_tent",
            "garage",
            "georgentor",
            "gym_01",
            "gym_entrance",
            "hall_of_finfish",
            "hall_of_mammals",
            "hamburg_hbf",
            "home_attic",
            "home_bedroom",
            "home_breakfast_nook",
            "home_family_room",
            "home_hallway",
            "home_hallway_2",
            "home_kitchen",
            "home_living_room",
            "hospital_room",
            "hotel_room",
            "indoor_pool",
            "industrial_pipe_and_valve_01",
            "industrial_pipe_and_valve_02",
            "kiara_interior",
            "large_corridor",
            "lebombo",
            "lookout",
            "lythwood_lounge",
            "lythwood_room",
            "machine_shop_01",
            "machine_shop_02",
            "machine_shop_03",
            "mall_bottom_floor_1",
            "mall_bottom_floor_2",
            "mall_bottom_floor_3",
            "mall_bottom_floor_stairs",
            "mall_bottom_floor_stairs_2",
            "mall_middle_floor_1",
            "mall_middle_floor_2",
            "mall_middle_floor_hallway",
            "mall_stairwell",
            "mall_top_floor_1",
            "mall_top_floor_10",
            "mall_top_floor_11",
            "mall_top_floor_12",
            "mall_top_floor_13",
            "mall_top_floor_2",
            "mall_top_floor_3",
            "mall_top_floor_4",
            "mall_top_floor_5",
            "mall_top_floor_6",
            "mall_top_floor_7",
            "mall_top_floor_8",
            "mall_top_floor_9",
            "mall_top_floor_elevator",
            "mall_top_floor_hallway",
            "mosaic_tunnel",
            "museum_of_ethnography",
            "music_hall_01",
            "music_hall_02",
            "mutianyu",
            "nursery",
            "old_bus_depot",
            "old_depot",
            "old_hall",
            "old_room",
            "parking_garage",
            "peppermint_powerplant",
            "phone_shop",
            "photo_studio_01",
            "pump_house",
            "reading_room",
            "restaurant_bar",
            "restaurant_dining_area",
            "restaurant_dining_area_2",
            "restaurant_dining_area_3",
            "restaurant_dining_area_5",
            "restaurant_table_1",
            "royal_esplanade",
            "sabie_tent",
            "sculpture_exhibition",
            "short_tunnel",
            "skylit_garage",
            "small_cathedral",
            "small_empty_house",
            "small_hangar_01",
            "small_hangar_02",
            "st_fagans_interior",
            "storeroom",
            "studio_small_01",
            "studio_small_02",
            "studio_small_03",
            "studio_small_04",
            "studio_small_05",
            "studio_small_06",
            "studio_small_07",
            "subway_entrance",
            "surgery",
            "teufelsberg_inner",
            "theater_01",
            "theater_02",
            "tv_studio",
            "vintage_measuring_lab",
            "vulture_hide",
            "whale_skeleton",
            "wooden_lounge",
            "yaris_interior_garage"
          ],
          "intensity": {
            "type": "list",
            "values": [
              0.1
            ]
          }
        },
        "lights": [
          {
            "light1": {
              "color_r": {
                "type": "list",
                "values": [
                  142
                ]
              },
              "color_g": {
                "type": "list",
                "values": [
                  188
                ]
              },
              "color_b": {
                "type": "list",
                "values": [
                  234
                ]
              },
              "rotation_x": {
                "type": "list",
                "values": [
                  0
                ]
              },
              "rotation_y": {
                "type": "list",
                "values": [
                  0
                ]
              },
              "rotation_z": {
                "type": "list",
                "values": [
                  0
                ]
              },
              "intensity": {
                "type": "list",
                "values": [
                  0.05
                ]
              },
              "size_meters": {
                "type": "list",
                "values": [
                  0.3
                ]
              },
              "distance_meters": {
                "type": "list",
                "values": [
                  0.3
                ]
              }
            },
            "percent": 100
          }
        ]
      },
      "camera_and_light_rigs": [
        {
          "cameras": [
            {
              "specifications": {
                "focal_length": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "sensor_width": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "wavelength": "visible",
                "resolution_w": 1280,
                "resolution_h": 960
              }
            }
          ],
          "lights": [
            {
              "wavelength": "visible"
            }
          ],
          "location": {
            "yaw": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "pitch": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "z": {
              "type": "list",
              "values": [
                0.85
              ]
            }
          }
        }
      ]
    },
    {
      "identities": {
        "ids": [
          119
        ],
        "renders_per_identity": 1
      },
      "accessories": {
        "glasses": [
          {
            "style": [
              "all"
            ],
            "lens_color": [
              "white",
              "blue",
              "red",
              "orange",
              "orange_red",
              "gray",
              "brown",
              "silver"
            ],
            "metalness": {
              "type": "list",
              "values": [
                0.4,
                0.4,
                0.4,
                0.8
              ]
            },
            "transparency": {
              "type": "list",
              "values": [
                0.95
              ]
            },
            "sex_matched_only": true,
            "percent": 100
          }
        ]
      },
      "facial_attributes": {
        "hair": [
          {
            "style": [
              "all"
            ],
            "color": [
              "chocolate_brown"
            ],
            "sex_matched_only": true,
            "ethnicity_matched_only": true,
            "percent": 100
          }
        ],
        "eyebrows": [
          {
            "style": [
              "all"
            ],
            "match_id_eyebrows": true,
            "sex_matched_only": true,
            "match_hair_color": true,
            "percent": 100
          }
        ],
        "head_turn": [
          {
            "pitch": {
              "type": "list",
              "values": [
                0
              ]
            },
            "yaw": {
              "type": "list",
              "values": [
                0
              ]
            },
            "roll": {
              "type": "list",
              "values": [
                0
              ]
            },
            "percent": 100
          }
        ]
      },
      "environment": {
        "hdri": {
          "name": [
            "photo_studio_01"
          ]
        }
      },
      "body": [
        {
          "enabled": true,
          "match_id_body_type": true,
          "percent": 100
        }
      ],
      "camera_and_light_rigs": [
        {
          "cameras": [
            {
              "specifications": {
                "focal_length": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "sensor_width": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "wavelength": "visible",
                "resolution_w": 1280,
                "resolution_h": 960
              }
            }
          ],
          "lights": [
            {
              "wavelength": "visible"
            }
          ],
          "location": {
            "yaw": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "pitch": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "z": {
              "type": "list",
              "values": [
                0.55
              ]
            }
          },
          "type": "head_orbit_with_tracking"
        }
      ]
    },
    {
      "identities": {
        "ids": [
          26
        ],
        "renders_per_identity": 1
      },
      "facial_attributes": {
        "facial_hair": [
          {
            "style": [
              "full_generic"
            ],
            "color": [
              "chocolate_brown"
            ],
            "match_hair_color": true,
            "relative_length": {
              "type": "list",
              "values": [
                0.02
              ]
            },
            "relative_density": {
              "type": "list",
              "values": [
                1
              ]
            },
            "percent": 100
          }
        ],
        "hair": [
          {
            "style": [
              "male_hair_short_frenchcrop"
            ],
            "color": [
              "chocolate_brown"
            ],
            "sex_matched_only": true,
            "ethnicity_matched_only": true,
            "percent": 100
          }
        ],
        "eyebrows": [
          {
            "style": [
              "all"
            ],
            "match_id_eyebrows": true,
            "sex_matched_only": true,
            "match_hair_color": true,
            "percent": 100
          }
        ],
        "head_turn": [
          {
            "pitch": {
              "type": "list",
              "values": [
                0
              ]
            },
            "yaw": {
              "type": "list",
              "values": [
                0
              ]
            },
            "roll": {
              "type": "list",
              "values": [
                0
              ]
            },
            "percent": 100
          }
        ]
      },
      "environment": {
        "hdri": {
          "name": [
            "photo_studio_01"
          ]
        }
      },
      "body": [
        {
          "enabled": true,
          "match_id_body_type": true,
          "percent": 100
        }
      ],
      "camera_and_light_rigs": [
        {
          "cameras": [
            {
              "specifications": {
                "focal_length": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "sensor_width": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "wavelength": "visible",
                "resolution_w": 1280,
                "resolution_h": 960
              }
            }
          ],
          "lights": [
            {
              "wavelength": "visible"
            }
          ],
          "location": {
            "yaw": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "pitch": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "z": {
              "type": "list",
              "values": [
                0.55
              ]
            }
          },
          "type": "head_orbit_with_tracking"
        }
      ]
    },
    {
      "identities": {
        "ids": [
          46
        ],
        "renders_per_identity": 1
      },
      "facial_attributes": {
        "hair": [
          {
            "style": [
              "all"
            ],
            "color": [
              "chocolate_brown"
            ],
            "sex_matched_only": true,
            "ethnicity_matched_only": true,
            "percent": 100
          }
        ],
        "eyebrows": [
          {
            "style": [
              "all"
            ],
            "match_id_eyebrows": true,
            "sex_matched_only": true,
            "match_hair_color": true,
            "percent": 100
          }
        ],
        "head_turn": [
          {
            "pitch": {
              "type": "list",
              "values": [
                -25
              ]
            },
            "yaw": {
              "type": "list",
              "values": [
                0
              ]
            },
            "roll": {
              "type": "list",
              "values": [
                0
              ]
            },
            "percent": 100
          }
        ]
      },
      "environment": {
        "hdri": {
          "name": [
            "photo_studio_01"
          ]
        }
      },
      "body": [
        {
          "enabled": true,
          "match_id_body_type": true,
          "percent": 100
        }
      ],
      "camera_and_light_rigs": [
        {
          "cameras": [
            {
              "specifications": {
                "focal_length": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "sensor_width": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "wavelength": "visible",
                "resolution_w": 1280,
                "resolution_h": 960
              }
            }
          ],
          "lights": [
            {
              "wavelength": "visible"
            }
          ],
          "location": {
            "yaw": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "pitch": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "z": {
              "type": "list",
              "values": [
                0.55
              ]
            }
          }
        }
      ]
    },
    {
      "identities": {
        "ids": [
          1
        ],
        "renders_per_identity": 1
      },
      "facial_attributes": {
        "hair": [
          {
            "style": [
              "male_hair_long_messy_1"
            ],
            "sex_matched_only": true,
            "ethnicity_matched_only": true,
            "relative_length": {
              "type": "range",
              "values": {
                "min": 0.5,
                "max": 0.8
              }
            },
            "relative_density": {
              "type": "range",
              "values": {
                "min": 0.5,
                "max": 1
              }
            },
            "color_seed": {
              "type": "range",
              "values": {
                "min": 0,
                "max": 1
              }
            },
            "percent": 100
          }
        ]
      },
      "body": [
        {
          "enabled": true,
          "match_id_body_type": true,
          "percent": 100
        }
      ],
      "environment": {
        "hdri": {
          "name": [
            "abandoned_church",
            "abandoned_hopper_terminal_01",
            "abandoned_hopper_terminal_02",
            "abandoned_hopper_terminal_03",
            "abandoned_hopper_terminal_04",
            "abandoned_parking",
            "abandoned_slipway",
            "abandoned_tank_farm_01",
            "abandoned_tank_farm_02",
            "abandoned_tank_farm_03",
            "abandoned_tank_farm_04",
            "abandoned_waterworks",
            "ahornsteig",
            "altanka",
            "approaching_storm",
            "arboretum",
            "aristea_wreck",
            "autumn_crossing",
            "autumn_forest_01",
            "autumn_forest_02",
            "autumn_forest_03",
            "autumn_ground",
            "autumn_hockey",
            "autumn_meadow",
            "autumn_park",
            "autumn_road",
            "balcony",
            "beach_parking",
            "bell_park_dawn",
            "bell_park_pier",
            "belvedere",
            "bergen",
            "bethnal_green_entrance",
            "between_bridges",
            "binnenalster",
            "birbeck_street_underpass",
            "birchwood",
            "bismarckturm",
            "blau_river",
            "blaubeuren_church_square",
            "blaubeuren_night",
            "blaubeuren_outskirts",
            "blouberg_sunrise_1",
            "blouberg_sunrise_2",
            "blue_grotto",
            "blue_lagoon",
            "blue_lagoon_night",
            "brick_factory_01",
            "brick_factory_02",
            "cambridge",
            "canary_wharf",
            "cannon",
            "cape_hill",
            "cave_wall",
            "cayley_lookout",
            "cedar_bridge",
            "champagne_castle_1",
            "chapmans_drive",
            "chinese_garden",
            "circus_maximus_1",
            "circus_maximus_2",
            "cliffside",
            "cloud_layers",
            "cloudy_cliffside_road",
            "cloudy_vondelpark",
            "colosseum",
            "construction_yard",
            "courtyard",
            "crosswalk",
            "crystal_falls",
            "dam_road",
            "delta_2",
            "derelict_highway_noon",
            "derelict_overpass",
            "derelict_underpass",
            "dikhololo_night",
            "dikhololo_sunset",
            "dirt_bike_track_01",
            "dresden_moat",
            "dresden_square",
            "driving_school",
            "dry_field",
            "dusseldorf_bridge",
            "eilenriede_labyrinth",
            "eilenriede_park",
            "emmarentia",
            "epping_forest_01",
            "epping_forest_02",
            "evening_road_01",
            "factory_yard",
            "felsenlabyrinth",
            "fish_eagle_hill",
            "fish_hoek_beach",
            "flower_hillside",
            "flower_road",
            "forest_cave",
            "forest_slope",
            "freight_station",
            "furry_clouds",
            "future_parking",
            "gamrig",
            "glass_passage",
            "goegap",
            "graffiti_shelter",
            "gray_pier",
            "green_point_park",
            "green_sanctuary",
            "greenwich_park",
            "greenwich_park_02",
            "greenwich_park_03",
            "hamburg_canal",
            "hansaplatz",
            "harties",
            "herkulessaulen",
            "hikers_cave",
            "hilltop_construction",
            "immenstadter_horn",
            "industrial_sunset",
            "kiara_1_dawn",
            "kiara_2_sunrise",
            "kiara_3_morning",
            "kiara_4_mid-morning",
            "kiara_5_noon",
            "kiara_6_afternoon",
            "kiara_7_late-afternoon",
            "kiara_8_sunset",
            "kiara_9_dusk",
            "killesberg_park",
            "kloetzle_blei",
            "kloofendal_48d_partly_cloudy",
            "kloppenheim_01",
            "kloppenheim_02",
            "kloppenheim_03",
            "kloppenheim_04",
            "kloppenheim_05",
            "kloppenheim_06",
            "kloppenheim_07",
            "konigsallee",
            "konzerthaus",
            "lakes",
            "lakeside",
            "lapa",
            "lauter_waterfall",
            "leadenhall_market",
            "learner_park",
            "lenong_1",
            "lenong_2",
            "lenong_3",
            "lilienstein",
            "limehouse",
            "lot_01",
            "lot_02",
            "lythwood_field",
            "lythwood_terrace",
            "mall_parking_lot",
            "mealie_road",
            "missile_launch_facility_01",
            "missile_launch_facility_02",
            "missile_launch_facility_03",
            "misty_dawn",
            "misty_pines",
            "modern_buildings",
            "modern_buildings_night",
            "monks_forest",
            "monte_scherbelino",
            "moonless_golf",
            "moonlit_golf",
            "mossy_forest",
            "moulton_falls_train_tunnel_east",
            "moulton_station_train_tunnel_west",
            "mpumalanga_veld",
            "mud_road",
            "muddy_autumn_forest",
            "museum_of_history",
            "museumplein",
            "nagoya_wall_path",
            "neuer_zollhof",
            "neurathen_rock_castle",
            "night_bridge",
            "ninomaru_teien",
            "nkuhlu",
            "noga",
            "noon_grass",
            "northcliff",
            "oberer_kuhberg",
            "old_apartments_walkway",
            "old_outdoor_theater",
            "old_tree_in_city_park",
            "ostrich_road",
            "outdoor_umbrellas",
            "palermo_park",
            "palermo_sidewalk",
            "palermo_square",
            "park_bench",
            "partial_eclipse",
            "paul_lobe_haus",
            "pedestrian_overpass",
            "piazza_bologni",
            "piazza_martin_lutero",
            "piazza_san_marco",
            "pillars",
            "pink_sunrise",
            "pond",
            "pond_bridge_night",
            "pool",
            "portland_landing_pad",
            "potsdamer_platz",
            "preller_drive",
            "pump_station",
            "pylons",
            "quarry_01",
            "quarry_02",
            "quarry_03",
            "quattro_canti",
            "qwantani",
            "railway_bridge_02",
            "railway_bridges",
            "rathaus",
            "red_hill_curve",
            "red_hill_straight",
            "red_wall",
            "reichstag_1",
            "reinforced_concrete_01",
            "residential_garden",
            "restaurant_dining_area_4",
            "restaurant_sidewalk_seating",
            "rhodes_memorial",
            "river_rocks",
            "river_walk_1",
            "river_walk_2",
            "rocky_ridge",
            "roof_garden",
            "roofless_ruins",
            "rooftop_day",
            "rooftop_night",
            "rooitou_park",
            "ruckenkreuz",
            "rural_landscape",
            "rural_winter_roadside",
            "rustig_koppie",
            "san_giuseppe_bridge",
            "satara_night",
            "satara_night_no_lamps",
            "schadowplatz",
            "secluded_beach",
            "shady_patch",
            "shanghai_bund",
            "signal_hill_dawn",
            "signal_hill_sunrise",
            "simons_town_harbour",
            "simons_town_rocks",
            "sisulu",
            "skate_park",
            "skukuza_golf",
            "small_cathedral_02",
            "small_cave",
            "small_harbor_01",
            "small_harbor_02",
            "small_rural_road",
            "small_rural_road_02",
            "snowy_forest_path_01",
            "snowy_forest_path_02",
            "snowy_park_01",
            "solitude_night",
            "spiaggia_di_mondello",
            "spruit_dawn",
            "spruit_sunrise",
            "stadium_01",
            "sterkspruit_falls",
            "stone_alley",
            "stone_alley_02",
            "stone_alley_03",
            "stone_pines",
            "straw_rolls_field_01",
            "stream",
            "street_lamp",
            "suburban_field_01",
            "suburban_field_02",
            "suburban_parking_area",
            "summer_stage_01",
            "summer_stage_02",
            "sunflowers",
            "sunny_vondelpark",
            "sunset_fairway",
            "sunset_forest",
            "sunset_in_the_chalk_quarry",
            "syferfontein_0d_clear",
            "syferfontein_18d_clear",
            "syferfontein_1d_clear",
            "syferfontein_6d_clear",
            "symmetrical_garden",
            "table_mountain_1",
            "table_mountain_2",
            "tears_of_steel_bridge",
            "teatro_massimo",
            "teufelsberg_ground_1",
            "teufelsberg_ground_2",
            "teufelsberg_lookout",
            "teufelsberg_roof",
            "the_lost_city",
            "the_sky_is_on_fire",
            "tiber_1",
            "tiber_2",
            "tiber_island",
            "tiergarten",
            "tucker_wreck",
            "ulmer_muenster",
            "umhlanga_sunrise",
            "under_bridge",
            "urban_alley_01",
            "urban_courtyard",
            "urban_courtyard_02",
            "urban_street_01",
            "urban_street_02",
            "urban_street_03",
            "urban_street_04",
            "vatican_road",
            "veld_fire",
            "venetian_crossroads",
            "venice_dawn_1",
            "venice_dawn_2",
            "venice_sunrise",
            "venice_sunset",
            "veranda",
            "versveldpas",
            "viale_giuseppe_garibaldi",
            "vignaioli",
            "vignaioli_night",
            "wasteland_clouds",
            "waterbuck_trail",
            "whipple_creek_gazebo",
            "whipple_creek_regional_park_01",
            "whipple_creek_regional_park_04",
            "white_cliff_top",
            "wide_street_01",
            "wide_street_02",
            "winter_evening",
            "winter_lake_01",
            "winter_river",
            "winter_sky",
            "wobbly_bridge",
            "wooden_motel",
            "woods",
            "xiequ_yuan",
            "yellow_field",
            "zhengyang_gate",
            "zwinger_night"
          ],
          "intensity": {
            "type": "list",
            "values": [
              0.75
            ]
          }
        }
      },
      "camera_and_light_rigs": [
        {
          "cameras": [
            {
              "specifications": {
                "focal_length": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "sensor_width": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "wavelength": "visible",
                "resolution_w": 1280,
                "resolution_h": 960
              }
            }
          ],
          "lights": [
            {
              "wavelength": "visible"
            }
          ],
          "location": {
            "yaw": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "pitch": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "z": {
              "type": "list",
              "values": [
                0.85
              ]
            }
          }
        }
      ]
    },
    {
      "identities": {
        "ids": [
          119
        ],
        "renders_per_identity": 1
      },
      "accessories": {
        "headwear": [
          {
            "style": [
              "female_hijab_1"
            ],
            "sex_matched_only": true,
            "percent": 100
          }
        ]
      },
      "facial_attributes": {
        "hair": [
          {
            "style": [
              "all"
            ],
            "color": [
              "chocolate_brown"
            ],
            "sex_matched_only": true,
            "ethnicity_matched_only": true,
            "percent": 100
          }
        ],
        "eyebrows": [
          {
            "style": [
              "all"
            ],
            "match_id_eyebrows": true,
            "sex_matched_only": true,
            "match_hair_color": true,
            "percent": 100
          }
        ],
        "head_turn": [
          {
            "pitch": {
              "type": "list",
              "values": [
                0
              ]
            },
            "yaw": {
              "type": "list",
              "values": [
                0
              ]
            },
            "roll": {
              "type": "list",
              "values": [
                0
              ]
            },
            "percent": 100
          }
        ]
      },
      "environment": {
        "hdri": {
          "name": [
            "photo_studio_01"
          ]
        }
      },
      "body": [
        {
          "enabled": true,
          "match_id_body_type": true,
          "percent": 100
        }
      ],
      "camera_and_light_rigs": [
        {
          "cameras": [
            {
              "specifications": {
                "focal_length": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "sensor_width": {
                  "type": "list",
                  "values": [
                    150.0
                  ]
                },
                "wavelength": "visible",
                "resolution_w": 1280,
                "resolution_h": 960
              }
            }
          ],
          "lights": [
            {
              "wavelength": "visible"
            }
          ],
          "location": {
            "yaw": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "pitch": {
              "type": "list",
              "values": [
                0.0
              ]
            },
            "z": {
              "type": "list",
              "values": [
                0.55
              ]
            }
          },
          "type": "head_orbit_with_tracking"
        }
      ]
    }
  ]
}


Reducing Demographic Bias: Sex, Age, Ethnicity

Our API features over 40,000 unique identities across a broad spectrum of skin tones and ages. Our Identities API allows you to programmatically select a distribution of identities that match your requirements across sex, skin tone, and age.

We provide a sample JSON with IDs that span the age and skin tone spectrum:

JSON example of multiple IDs

"humans": [{
  "identities": {
    "ids": [25,119,121,128,132,1,46,77,106,129,2,93,1037,2415,31,76,97,94,35,36,90,26,24],
    "renders_per_identity": 1
  },
...
}]

Example IDs

Skin Tone

Age


Reducing Head Pose & Camera Angle Bias

Few datasets have a wide distribution of head turn angles and extreme camera angles. Our API provides programmatic control of head turn which allow for simulation of many scenarios; and comes with both face and body 3d landmarks.

These head turns are compatible with hats, glasses, and face masks, which serve as effective occlusions to train against.

In addition to head turn, we provide samples of camera angles. To reduce bias, consider turning the camera's "follow_head_orientation" to true, and then adding vertical and horizontal camera angle ranges (see camera location documentation). With "follow_head_orientation", the camera first follows the front of the face while head turn is applied, and subsequently, the additional camera vertical and horizontal range is applied.

Example JSON of head pose

"facial_attributes": {
  "hair": [{
    "style": ["male_hair_combover_1"],
    "color": ["chocolate_brown"],
    "sex_matched_only": true,
    "ethnicity_matched_only": true,
    "percent": 100
  }],
  "eyebrows": [{
    "style": ["male_manicured_high_1"],
    "sex_matched_only": true,
    "match_hair_color": true,
    "percent": 100
  }],
  "head_turn": [{
    "pitch": {
      "type": "list",
      "values": [0]
    },
    "yaw": {
      "type": "list",
      "values": [25]
    },
    "roll": {
      "type": "list",
      "values": [0]
    },
    "percent": 100
  }]
},
"camera_and_light_rigs": [{
  "type": "head_orbit_with_tracking ",
  "location": {
    "pitch": {
      "type": "range",
      "values": {
        "min": 0,
        "max": 0
      }
    },
    "yaw": {
      "type": "range",
      "values": {
        "min": 0,
        "max": 0
      }
    },
    "roll": {
      "type": "list",
      "values": [0]
    },
    "x": {
      "type": "range",
      "values": {
        "min": 0,
        "max": 0
      }
    },
    "y": {
      "type": "range",
      "values": {
        "min": 0,
        "max": 0
      }
    },
    "z": {
      "type": "range",
      "values": {
        "min": 0.55,
        "max": 0.55
      }
    }
  },
  "cameras": [{
    "name": "default",
    "specifications": {
      "resolution_h": 960,
      "resolution_w": 1280,
      "focal_length": {
        "type": "list",
        "values": [150.0]
      },
      "sensor_width": {
        "type": "list",
        "values": [150.0]
      },
      "wavelength": "visible"
    },
    "relative_location": {
      "pitch": {
        "type": "list",
        "values": [0]
      },
      "yaw": {
        "type": "list",
        "values": [0]
      },
      "roll": {
        "type": "list",
        "values": [0]
      },
      "x": {
        "type": "list",
        "values": [0]
      },
      "y": {
        "type": "list",
        "values": [0]
      },
      "z": {
        "type": "list",
        "values": [0]
      }
    },
    "advanced": {
      "denoise": true,
      "noise_threshold": 0.017,
      "lens_shift_vertical": {
        "type": "list",
        "values": [0]
      },
      "lens_shift_horizontal": {
        "type": "list",
        "values": [0]
      },
      "window_offset_vertical": {
        "type": "list",
        "values": [0]
      },
      "window_offset_horizontal": {
        "type": "list",
        "values": [0]
      }
    }
  }]
}],
"environment": {
  "hdri": {
    "name": ["photo_studio_01"]
  }
}


Visual examples of head poses:


Accessory Occlusions

ID verification systems also need to tolerate occlusions by accessories. Our API offers programatic additions of many varieties of hats, glasses, and face masks.

On the output side all generated images come with segmentation (Jupyter Notebook) and face and body 3d landmarks.

Example JSON of glasses accessories

"accessories": {
  "glasses": [{
    "style": ["all"],
    "lens_color": ["default"],
    "transparency": {
      "type": "range",
      "values": {
        "min": 1,
        "max": 1
      }
    },
    "metalness": {
      "type": "range",
      "values": {
        "min": 0.03,
        "max": 0.03
      }
    },
    "sex_matched_only": true,
    "percent": 100
  }]
}
...


Visual examples of accessories:


Varying Hair & Facial Hair per Identity

Changing hairstyles, eyebrow styles, and especially facial hair are major confounds to some ID verification systems. Our API provides the ability to output a wide variety of hair styles and facial hair grooms, and also vary the color and length for any given identity.

By setting multiple renders_per_identity, each identity will have varying styles and color and increase robustness of your models. See the following JSON example and images.

Example JSON of IDs associated with hair

{
  "humans": [{
    "identities": {
      "ids": [25, 119, 121, 128, 132, 1, 46, 77, 106, 129, 2, 93, 1037, 2415, 31, 76, 97, 94, 35, 36, 90, 26, 24],
      "renders_per_identity": 100
    },
    "facial_attributes": {
      "hair": [{
        "style": ["all"],
        "color": ["all"],
        "sex_matched_only": true,
        "ethnicity_matched_only": true,
        "percent": 100
      }],
      "eyebrows": [{
        "style": ["all"],
        "match_id_eyebrows": false,
        "sex_matched_only": true,
        "match_hair_color": true,
        "percent": 100
      }],
      "facial_hair": [{
        "style": ["all"],
        "color": ["all"],
        "match_hair_color": true,
        "percent": 100
      }],
    }
  }]
}
...


Visual examples of hair styles and colors:


Lighting Variety

Being robust to "harsh" lighting environments is also a challenge for ID verification systems. Our APIs not only provide a large collection of indoor environments, outdoor environments, but also allows for placement of custom directional lights to simulate additional variety of light colors and intensities. Additionally, we allow for NIR-spectrum lighting and cameras.

The following JSON example uses directional lights to simulate glow from a computer monitor.

JSON environment lights simulating a "monitor" glow

"lights": [{
  "type": "rect",
  "color": {
    "red": {
      "type": "list",
      "values": [142]
    },
    "blue": {
      "type": "list",
      "values": [234]
    },
    "green": {
      "type": "list",
      "values": [188]
    }
  },
  "intensity": {
    "type": "list",
    "values": [0.05]
  },
  "wavelength": "visible",
  "size_meters": {
    "type": "list",
    "values": [0.3]
  },
  "relative_location": {
    "x": {
      "type": "list",
      "values": [0]
    },
    "y": {
      "type": "list",
      "values": [0]
    },
    "z": {
      "type": "list",
      "values": [0.3]
    },
    "yaw": {
      "type": "list",
      "values": [0]
    },
    "roll": {
      "type": "list",
      "values": [0]
    },
    "pitch": {
      "type": "list",
      "values": [0]
    }
  }
}]


Visual examples of lighting: