Ingest multi-labeled data using the API

This guide provides a quick walk-through on how to upload and update time-series data with multiple labels using the Edge Impulse API.

Getting Started

Prerequisites

• API Key - Obtain from your project settings on Edge Impulse.

• Example Github repository - Clone the following repository, it contains the scripts and the example files:

  Copy

  git clone git@github.com:edgeimpulse/example-multi-label-ingestion-via-api.git

Setup Your Environment

Export your API key to use in the upload scripts:

export EI_PROJECT_API_KEY='your_api_key_here'

Prepare Your Data

• Data File: JSON formatted time-series data. See the Data acquisition format speicification

• structured_labels.labels File: JSON with structured labels. See the specification format

Upload Data

Use the upload.sh script to send your data and labels to Edge Impulse:

#!/bin/bash
if [[ -z "$EI_PROJECT_API_KEY" ]]; then
    echo "Missing EI_PROJECT_API_KEY env variable"
    exit 1
fi

curl -X POST \
    -H "x-api-key: $EI_PROJECT_API_KEY" \
    -H "Content-Type: multipart/form-data" \
    -F "data=@updown.3.json" \
    -F "data=@structured_labels.labels" \
    https://ingestion.edgeimpulse.com/api/training/files

Update Existing Samples

To update a sample, run update-sample.sh with the required project and sample IDs:

sh update-sample.sh --project-id <your_project_id> --sample-id <your_sample_id>

We hope this tutorial has helped you to understand how to ingest multi-label data samples to your Edge Impulse project. If you have any questions, please reach out to us on our forum.