---
title: "AI food logging from voice audio"
method: POST
path: "/foods/log/audio"
tags: ["Nutrition"]
---

# AI food logging from voice audio

`POST /foods/log/audio`

## Request

- Base URL: `https://exercise-api.ymove.app/api/v2`
- URL: `https://exercise-api.ymove.app/api/v2/foods/log/audio`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

Send a base64-encoded audio recording of someone describing a meal. The audio is transcribed and then analyzed like a text log; the response includes the transcript alongside identified foods with full nutrition data. Pro plan and above. Uses your nutrition analysis quota.

## Request body

- object
  - `audio` string, required: Base64-encoded audio recording (max 25MB encoded)
  - `format` 'mp3' | 'mp4' | 'm4a' | 'wav' | 'webm' | 'ogg' | 'flac'

## Response `200`

Transcript plus identified foods with nutrition data

- FoodAnalysisResult
  - `data` object
    - `items` object[]
      - `name` string: AI-identified food name
      - `estimatedGrams` number: Estimated portion in grams
      - `confidence` 'high' | 'medium' | 'low': AI confidence level
      - `matchedFood` object, nullable: Matched food from the database (null if no match)
        - `id` string
        - `name` string
        - `servingSizeG` number
      - `nutrition` object, nullable: Calculated nutrition based on matched food and estimated portion (null if no match)
        - `calories` number
        - `protein` number
        - `fat` number
        - `carbs` number
    - `totals` object
      - `calories` number
      - `protein` number
      - `fat` number
      - `carbs` number
  - `usage` object
    - `analyses_used` integer
    - `analyses_included` integer
    - `is_overage` boolean
    - `overage_charge` number

## Other responses

- `403`: Requires Pro plan or higher

---

[API](https://skmtc.dev/ymove/apis/ymove-fitness-api.md) · [All operations](https://skmtc.dev/ymove/apis/ymove-fitness-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ymove/apis/ymove-fitness-api/revisions/6636f2b4a343?raw)