Skip to main content
POST
/
api
/
generatePlatingGuidance
Generate Plating Guidance
curl --request POST \
  --url https://api.example.com/api/generatePlatingGuidance \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipeTitle": "<string>",
  "ingredients": [
    {}
  ],
  "instructions": [
    {}
  ]
}
'
{
  "success": true,
  "data": {
    "platingNotes": "<string>",
    "servingVessel": "<string>",
    "servingTemp": "<string>",
    "storageGuide": "<string>",
    "shelfLife": {
      "fridge": 123,
      "freezer": {}
    }
  },
  "error": "<string>",
  "details": "<string>"
}

Overview

The /api/generatePlatingGuidance endpoint generates professional plating and serving guidance for a recipe. It analyzes the recipe context to provide:
  • Specific, actionable plating suggestions
  • Ideal serving vessel recommendations
  • Optimal serving temperature
  • Proper storage instructions
  • Realistic shelf life estimates (fridge and freezer)

Request

recipeTitle
string
required
The title of the recipe.Example: "Gochujang Pasta", "Chocolate Lava Cake"
ingredients
array
Full ingredient list of the recipe. Helps the AI understand what’s in the dish.
instructions
array
Full cooking instructions. Helps the AI understand how the dish is prepared.Example: ["Heat butter in a pan", "Add gochujang and cream", "Toss with pasta"]

Response

Success Response

success
boolean
required
Always true for successful responses
data
object
required
Plating and serving guidance data

Error Response

error
string
Error message describing what went wrong
details
string
Additional error details (if available)

Examples

curl -X POST https://your-domain.com/api/generatePlatingGuidance \
  -H "Content-Type: application/json" \
  -d '{
    "recipeTitle": "Gochujang Pasta",
    "ingredients": [
      {
        "groupName": "For the sauce",
        "ingredients": [
          {"amount": "2", "units": "tablespoons", "ingredient": "gochujang"},
          {"amount": "1/2", "units": "cup", "ingredient": "heavy cream"},
          {"amount": "2", "units": "tablespoons", "ingredient": "butter"}
        ]
      },
      {
        "groupName": "Main ingredients",
        "ingredients": [
          {"amount": "8", "units": "ounces", "ingredient": "pasta"}
        ]
      }
    ],
    "instructions": [
      "Cook pasta according to package directions.",
      "Heat butter in a pan, add gochujang and cream.",
      "Toss pasta with sauce and serve."
    ]
  }'

Success Response Example

{
  "success": true,
  "data": {
    "platingNotes": "Twirl pasta into a nest in the center of the bowl. Drizzle extra sauce around the edges and garnish with sliced green onions and a sprinkle of sesame seeds for visual contrast. A light dusting of grated parmesan adds richness.",
    "servingVessel": "shallow pasta bowl",
    "servingTemp": "hot",
    "storageGuide": "Store in an airtight container in the refrigerator for up to 3 days. The sauce may thicken when cold. Reheat gently on the stovetop with a splash of water or cream to restore the creamy consistency. Not recommended for freezing as cream-based sauces can separate when thawed.",
    "shelfLife": {
      "fridge": 3,
      "freezer": null
    }
  }
}

Error Response Example

{
  "error": "Recipe title is required"
}

AI Model

This endpoint uses the llama-3.3-70b-versatile model via Groq with:
  • Temperature: 0.3 (lower temperature for more consistent, practical guidance)
  • Max tokens: 1024
This endpoint requires a valid Groq API key configured as GROQ_API_KEY in your environment variables.
While only recipeTitle is required, providing full recipe context (ingredients and instructions) results in much more accurate and helpful plating guidance, storage instructions, and shelf life estimates.

Build docs developers (and LLMs) love