Age Estimation API

async function submitAgeEstimation(accessToken, userImageFile, options = null) {
  const url = `https://verification.didit.me/v2/age-estimation/`;
 
  // Create a FormData instance
  const formData = new FormData();
  formData.append('user_image', userImageFile);
 
  // Add options if provided
  if (options) {
    formData.append('options', JSON.stringify(options));
  }
 
  const requestOptions = {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${accessToken}`
    },
    body: formData
  };
 
  try {
    const response = await fetch(url, requestOptions);
 
    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(errorData.error?.message || errorData.detail || 'Unknown error occurred');
    }
 
    return await response.json();
  } catch (error) {
    console.error('Error in age estimation:', error);
    throw error;
  }
}
 
// Example usage
async function performAgeEstimation() {
  try {
    // 1. Get client token (implement based on auth documentation)
    const token = await getClientToken();
 
    // 2. Get image file (from file input or other source)
    const userImageFile = document.getElementById('user-image-input').files[0];
 
    // 3. Custom options (optional)
    const options = {
      face_liveness_score_decline_threshold: 35,
      age_estimation_decline_threshold: 21,
    };
 
    // 4. Submit age estimation
    const result = await submitAgeEstimation(
      token.access_token,
      userImageFile,
      options
    );
 
    console.log('Age estimation result:', result);
    console.log(`Estimated age: ${result.liveness.age_estimation} years`);
 
    return result;
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}

import requests
import json
 
def submit_age_estimation(access_token, user_image_file, options=None):
    """
    Submit a facial image for age estimation.
 
    Args:
        access_token (str): The access token for authentication.
        user_image_file (file): The user's face image file object.
        options (dict, optional): Customization options for thresholds.
 
    Returns:
        dict: The age estimation results.
    """
    url = "https://verification.didit.me/v2/age-estimation/"
 
    headers = {
        "Authorization": f"Bearer {access_token}"
    }
 
    files = {
        "user_image": user_image_file
    }
 
    # Prepare data dictionary for options
    data = {}
    if options:
        data['options'] = json.dumps(options)
 
    try:
        response = requests.post(url, headers=headers, files=files, data=data)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error in age estimation: {e}")
        if hasattr(e, 'response') and e.response:
            print(f"Response: {e.response.text}")
        raise
 
# Example usage
def perform_age_estimation():
    try:
        # 1. Get client token (implement based on auth documentation)
        token = get_client_token()
 
        # 2. Custom options (optional)
        options = {
            "face_liveness_score_decline_threshold": 35,
            "age_estimation_decline_threshold": 21,
        }
 
        # 3. Get image file (from file input or other source)
        with open("user_image.jpg", "rb") as user_img:
            # 4. Submit age estimation
            result = submit_age_estimation(
                token["access_token"],
                user_img,
                options
            )
 
        print("Age estimation result:", result)
        print(f"Estimated age: {result['liveness']['age_estimation']} years")
 
        return result
    except Exception as e:
        print(f"Error: {e}")
        raise