Three APIs, one developer surface. Image Diagnosis (crop disease from a photo with AI focus areas). Crops and Media API (text and image knowledge and diagnostic funnels for maize and rice). Machine Learning (crop recommendation and yield prediction). Each works inside agriculture by default, and a lot of them work outside it. This page introduces all three and the kinds of products we have seen developers build on top.
# Good API product design asks:
who: "farmer, advisor, extension team, researcher"
input: "image, text, location, weather, language"
risk: "low, review-needed, regulated decision"
output: "ranked signal + evidence + next-step guidance"
handoff: "show uncertainty, cite sources, escalate when needed"The Four APIs
Each API does one thing well and shares the same auth, billing meter, and locale handling as the others. Brief introductions below; the detailed developer reference for each is one click away.
Send a crop photo, receive a disease prediction with a confidence score and an AI focus-area overlay that shows what the model attended to. Four crops today: maize, rice, tomato, cassava. Multipart upload for user-facing flows; raw-key inference for server-side pipelines.
Four operations under one per-crop URL: text chat (KB passages), text diagnose (multi-turn funnel), media search (reference images), media diagnose (image funnel). Currently maize and rice, our two production experts.
Crop recommendation from soil + climate inputs (Random Forest over 22 crops). Maize yield prediction from fertilizer + soil + climate (XGBoost on Sub-Saharan Africa trials). Both with reasoning traces, no black boxes.
Beyond Agriculture
We built these APIs for agriculture because that is where our research and field validation lives. The underlying surfaces, annotated images, curated text, a tag vocabulary, a translation pipeline that handles African languages, fit a lot of adjacent problems. Some ideas we have seen, some we expect:
The disease KB is a structured pivot from natural-language descriptions to disease ontology, useful for agricultural courseware, extension officer training, museum/curriculum work, or seeding annotation tasks in a research dataset. The diagnostic funnel is itself a teaching loop.
Wherever a photo needs a first-pass classification with a confidence score, the same upload + inference pattern transfers. Quality-control screens on a packing line, citizen-science contributions, supply-chain inspection, pair our crop classes with the operator's manual review.
The reasoning-trace contract, input → ranked output + explanation, fits decision-support work outside agronomy too. Students learning ML can study a working RAG + classification system; researchers can use it as a baseline to benchmark against; product teams can prototype before training their own model.
We do not advertise these as primary use cases, agriculture is. But the API contract is general enough that imagination is genuinely the limit. If you build something interesting outside our home territory, tell us about it.
Developer Scenarios
These patterns show where FildraAI APIs fit inside real products. The endpoint documentation explains the exact request and response details.
Add image-based crop issue triage to a mobile app so farmers can capture a symptom, see ranked possibilities, and understand when expert review is needed.
Help agronomists, call centers, and extension officers review submitted images with consistent visual evidence, source-backed context, and clear uncertainty.
Support structured scouting, field trials, and regional monitoring by turning repeated submissions into comparable signals that can be reviewed over time.
Build multilingual agricultural experiences where the same core signal can be presented with local language, crop, region, and review context.
Pair model signals with practical context so users see what the output means, what it does not prove, and what should be verified locally.
Best Practices
Agricultural APIs are most useful when the surrounding product sets expectations, shows evidence, and keeps human judgment in the workflow.
Present ranked possibilities, confidence, and evidence clearly. Do not frame model output as a confirmed diagnosis or a pesticide instruction.
Show the image, top predictions, and visual focus areas together so users can inspect whether the output matches what they see in the field.
Ask for crop, location, growth stage, and recent field conditions before turning a model result into user-facing guidance.
Route severe, uncertain, regulated, or high-value cases to a qualified person instead of encouraging automatic action.
What Developers Get
The current solution is designed around authenticated HTTP endpoints, staged-image processing, and diagnosis support flows rather than a packaged SDK.
Current image diagnosis support covers cassava, maize, rice, and tomato under the models you have already integrated.
End users upload files to the API gateway, and the server handles storage transfer on their behalf to reduce client-side storage coupling.
Internal and server-side workflows can call the diagnosis API directly with a staged object key instead of re-uploading the image payload.
Diagnosis workflows are designed to pair ranked predictions with visual evidence so model outputs are easier to inspect and explain.
Knowledge-backed diagnosis endpoints can complement model predictions with structured profile content for interpretation and follow-up guidance.
Integration is done through documented HTTP endpoints and API keys. We do not currently advertise a dedicated SDK on this page.
Commercial Model
FildraAI uses normalized credits so light requests and expensive workflows do not cost the same. This keeps the free funnel useful while protecting the business from heavy variable-cost usage.
Free includes 50 API credits/month. Basic is $15/month with 150 included credits. Pro is $49/month with 600 included credits. Top-ups are $3/20, $10/80, and $25/250 credits.
Field Guide Free includes 150 mobile farm-help credits each month. Basic is $10/month with 600 credits, a 30-message chat limit, 3-year farm memory, and 90-day raw media retention. Pro is $25/month with 1,800 credits, a 45-message chat limit, 5-year farm memory, and 365-day raw media retention.
Standard API calls burn 1 credit. Machine learning inference and image diagnosis burn 2 credits. Maize or rice expert chat burns 3 credits.
Request developer access and we can guide you to the right integration path, whether you need user uploads through the gateway or server-side diagnosis workflows.