FAQ
Frequently asked questions
Quick answers about predictions, pricing, and using Humanform from your apps or AI assistants. For deeper reference, see API docs and design examples.
- What is Humanform?
- Humanform is a commercial anthropometric prediction API built by Fieldwork. You send age, sex, percentile, country, and a measurement name, and the API returns a population-level body dimension in mm, cm, or inches. It is designed for product design, ergonomics, CAD, and engineering workflows rather than individual medical diagnosis.
- How accurate are the predictions?
- Predictions are statistical estimates, then country-adjusted for 149 non-US populations. Each result is checked against empirical bounds before credits are charged. They are useful for design envelopes and percentile ranges, but you should validate critical dimensions independently before production use.
- What countries are supported?
- The API supports 150 ISO country codes, including the United States. Non-US predictions are country-adjusted for regional body proportions. See the /countries page for the full list.
- How does the free tier work?
- Create a dashboard account at no cost. When your credit balance is zero, you still get 10 successful predictions per rolling 24-hour window. Paid credit packs add balance for production volume. Credits are deducted only after a prediction passes validation and returns successfully.
- How do I use Humanform with Claude, Cursor, or ChatGPT?
- Install the @humanform/mcp npm package and add it to your MCP client config with your HUMANFORM_API_KEY. The server exposes predict_measurement, list_measurements, and list_countries with the same behavior as the REST API. See /mcp for install steps and /examples for natural-language prompt ideas.
- What measurements can I predict?
- Humanform exposes 148 named measurements such as Stature, SittingEyeHeight, HandLength, and WristCircumference. Ninety-one are directly modeled with separate female and male predictions; 57 are derived from related modeled dimensions. Browse the grouped list at /measurements or call GET /v1/public/measurements.
- How is the API authenticated?
- Send Authorization: Bearer hf_live_... on authenticated routes. Create and rotate keys in the dashboard. Public routes such as /v1/public/stats and /v1/public/measurements do not require a key.
- Do you use my API requests to train your models?
- No. Request parameters are used only to generate your prediction and for billing and usage purposes as described in our Privacy Policy. They are never used to train or improve our underlying models.