Image diagnosis, AI focus areas, and supporting knowledge for authenticated developer workflows

# Diagnose a maize image through the public upload gateway
curl -X POST "https://api.yourdomain.com/api/v1/diagnose?plant=maize&top_k=3&locale=en-us" \
  -H "X-Api-Key: YOUR_USER_API_KEY" \
  -F "image=@maize_leaf.jpg"

# Server-side inference when the image is already staged in storage
import requests

base_url = "https://api.yourdomain.com"
api_key = "YOUR_SERVER_OR_USER_API_KEY"

url = f"{base_url}/api/v1/image_diagnosis/infer/basic"
payload = {
    "plant": "rice",
    "raw_key": "uploads/diagnose/team-42/rice/rice_leaf.jpg",
    "locale": "en-us",
    "job_id": "demo-job-001",
    "top_k": 3,
    "country": "zambia"
}
headers = {
    "X-Api-Key": api_key,
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()

result = response.json()
print(result)

// Server-side diagnosis + filtered knowledge sections
async function diagnoseWithKnowledge(rawKey) {
  const response = await fetch("https://api.yourdomain.com/api/v1/image_diagnosis/infer/with_knowledge", {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Api-Key': 'YOUR_SERVER_OR_USER_API_KEY'
    },
    body: JSON.stringify({
      plant: 'tomato',
      raw_key: rawKey,
      locale: 'en-us',
      top_k: 2,
      sections: ['visual_profile', 'lookalikes', 'decision_support'],
      lookalikes: true
    })
  });

  return await response.json();
}