AI Nutrition

Create an Inquiry with workflowId: "ai-nutrition". GOFA hosts the welcome page, declaration, meal-photo selection or capture, analysis, result, and completion page. This Hosted Inquiry service covers one meal-photo analysis. It does not expose nutrition chat, meal plans, or a customer-configurable workflow.

User journey

1. Your backend creates the Inquiry and opens its launch URL for the user.
2. The user confirms the service declaration and takes or selects a meal photo.
3. GOFA analyzes the image and saves a structured result.
4. The user returns to your website.
5. Your backend reads the Inquiry and verifies the saved result.

The enterprise API does not accept image uploads. The user supplies the image directly inside the Hosted Flow. For a failed or unreadable meal, follow the on-screen retry action; see Lifecycle and retries.

Result fields

Required foodData fields are name, calories, protein, carbs, and fats. The numeric values are nonnegative estimates: calories is in kcal; protein, carbs, fats, and optional sugar are in grams. Optional fields include dishName, cuisineType, visibleIngredients, portionLabel, portionConfidence, estimationBasis, disclaimer, sugar, mealGrade, and localizedText.

Do not require optional fields or derive numerical values by parsing text. Portion estimates and uncertainty should remain visible when you present the result. The deprecated healthScore field is not a required integration field.

Illustrative data.result:

{
  "id": "01234567-89ab-4cde-8fab-0123456789ab",
  "type": "ai-nutrition",
  "version": 1,
  "source": "server_ai",
  "language": "en",
  "text": "A chicken salad with vegetables and dressing. Values are estimates based on the visible portion.",
  "foodData": {
    "name": "Chicken salad",
    "calories": 420,
    "protein": 32,
    "carbs": 24,
    "fats": 22
  },
  "completedAt": "2026-11-11T02:03:00.000Z"
}

The example describes the API shape, not a measured meal or a nutritional promise. Refreshing your result page should retrieve this saved result, not trigger another analysis or credit deduction.

Other nutrition integrations

Existing authenticated GOFA applications use separate AI Nutrition client APIs. Those endpoints and credentials are not part of the Hosted Inquiry contract described here.