Getting started

Quickstart

Generate your first AI recipe in under five minutes. This guide walks through creating an account, getting an API key, and making your first authenticated request.

Base URLs

  • REST API: https://api.dishora.app/api
  • AI service: https://ai.dishora.app
  • Sandbox: use a dsk_test_ key against the same URLs. 10 free lifetime calls, 10 req/min, never billed.

1. Create an account & get a key

Sign in at the developer dashboard and create a new API key. You鈥檒l get two keys: a dsk_test_ sandbox key and a dsk_live_ production key. Store them as environment variables, and never commit them to source control.

shell
export DISHORA_API_KEY="dsk_live_xxxxxxxxxxxxxxxxxxxx"

2. Make your first request

Send a POST to /v1/recipes/generate with your ingredients and constraints. The call is synchronous: a few seconds later you get back a fully structured recipe (title, ingredients, instructions, macros, tags).

curl https://api.dishora.app/api/v1/recipes/generate \
  -H "Authorization: Bearer $DISHORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ingredients": ["chicken", "rice", "tomato"],
    "cuisine": "indian",
    "dietary_restrictions": ["gluten-free"],
    "time_available": 30,
    "skill_level": "comfortable",
    "servings": 2
  }'

3. Inspect the response

200 OK
{
  "data": {
    "id": "recipe_66a1b2c3",
    "name": "One-Pan Indian Chicken & Rice",
    "emoji": "馃崨",
    "cuisine": "indian",
    "timeEstimate": 30,
    "calorieEstimate": 520,
    "servings": 2,
    "difficulty": "Medium",
    "ingredients": [
      { "name": "chicken thigh", "quantity": "400", "householdMeasurement": "400g", "isOptional": false }
    ],
    "steps": [
      "Heat oil and brown the chicken...",
      "Add spices and toast briefly...",
      "Add rice and water, cover and simmer 18 min."
    ],
    "nutrition": { "calories": 520, "protein": "38g", "carbs": "48g", "fat": "14g", "fiber": "5g" },
    "whyThisRecipe": "A fragrant, gluten-free one-pan dinner ready in 30 minutes.",
    "createdAt": "2026-07-03T18:02:11+00:00"
  }
}

4. Try the transforms

Once you have a recipe, pipe it through the AI transforms: rewrite the tone, make it budget-friendly, healthify it, or adapt it to a different cooking method.

rewrite-tone (POST /api/v1/rewrite-tone)
curl https://ai.dishora.app/api/v1/rewrite-tone \
  -H "Authorization: Bearer $DISHORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "steps": ["Boil pasta...", "Toss with sauce and serve."], "from_tone": "normal", "to_tone": "funny" }'

You鈥檙e ready to build.

Next: authenticate securely and understand rate limits.

Authentication
Every response is validated for allergens and dietary violations before it鈥檚 returned.