واجهة برمجة تطبيقات معالجة الصور

curl -X POST https://api.ishotaphoto.com/v1/remove-background \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "output_format": "png",
    "background_color": null
  }'

{
  "success": true,
  "credits_used": 1,
  "credits_remaining": 249,
  "result": {
    "image_url": "https://cdn.ishotaphoto.com/results/abc123.png",
    "expires_at": "2025-01-08T12:00:00Z"
  }
}

curl -X POST https://api.ishotaphoto.com/v1/replace-background \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "background": {
      "type": "color",
      "value": "#FFFFFF"
    }
  }'

{
  "success": true,
  "credits_used": 1,
  "credits_remaining": 248,
  "result": {
    "image_url": "https://cdn.ishotaphoto.com/results/def456.jpg",
    "expires_at": "2025-01-08T12:00:00Z"
  }
}

curl -X POST https://api.ishotaphoto.com/v1/detect-faces \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg"
  }'

{
  "success": true,
  "credits_used": 1,
  "faces": [
    {
      "confidence": 0.98,
      "bounding_box": {
        "x": 120, "y": 80,
        "width": 200, "height": 250
      }
    }
  ]
}

curl -X POST https://api.ishotaphoto.com/v1/detect-emotions \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg"
  }'

{
  "success": true,
  "credits_used": 1,
  "faces": [
    {
      "emotions": {
        "neutral": 0.85,
        "happy": 0.10,
        "surprised": 0.03,
        "sad": 0.02
      }
    }
  ]
}

curl -X POST https://api.ishotaphoto.com/v1/detect-keypoints \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg"
  }'

{
  "success": true,
  "credits_used": 1,
  "faces": [
    {
      "keypoints": {
        "left_eye": {"x": 180, "y": 120},
        "right_eye": {"x": 260, "y": 118},
        "nose_tip": {"x": 220, "y": 170},
        "mouth_center": {"x": 222, "y": 210}
      }
    }
  ]
}

curl -X POST https://api.ishotaphoto.com/v1/generate-passport-photo \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "country_code": "US",
    "document_type": "passport"
  }'

{
  "success": true,
  "credits_used": 1,
  "result": {
    "image_url": "https://cdn.ishotaphoto.com/results/ghi789.jpg",
    "dimensions": {"width": 600, "height": 600},
    "dpi": 300,
    "compliant": true
  }
}

curl -X POST https://api.ishotaphoto.com/v1/validate-photo \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "country_code": "US",
    "document_type": "passport"
  }'

{
  "success": true,
  "credits_used": 1,
  "valid": false,
  "checks": {
    "face_detected": {"pass": true},
    "background": {"pass": false, "reason": "Not white"},
    "head_position": {"pass": true},
    "expression": {"pass": true, "value": "neutral"}
  }
}

curl -X POST https://api.ishotaphoto.com/v1/enhance-image \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "enhancements": ["brightness", "sharpness", "denoise"]
  }'

{
  "success": true,
  "credits_used": 1,
  "result": {
    "image_url": "https://cdn.ishotaphoto.com/results/jkl012.jpg",
    "enhancements_applied": ["brightness", "sharpness", "denoise"],
    "expires_at": "2025-01-08T12:00:00Z"
  }
}

curl -X POST https://api.ishotaphoto.com/v1/estimate-head-pose \
  -H "Authorization: Bearer isp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg"
  }'

{
  "success": true,
  "credits_used": 1,
  "faces": [
    {
      "pose": {
        "pitch": 2.5,
        "yaw": -1.2,
        "roll": 0.8
      },
      "front_facing": true
    }
  ]
}