Skip to main content
POST
/
datasets
/
upload
Upload Dataset
curl --request POST \
  --url https://api.nextprotocol.fr/datasets/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form subject=ohwx \
  --form name=mon-dataset \
  --form 'description=Dataset de photos portrait' \
  --form gender=man \
  --form 'captions=<string>' \
  --form 'images=<string>' \
  --form 'additional_info={"from_origin": "toolskit", "requested_by": "user-123", "metadata": {}}' \
  --form images.items='@example-file'
{
  "id": "<string>",
  "subject": "ohwx",
  "name": "mon-dataset",
  "description": "Dataset de photos portrait",
  "gender": "man",
  "image_count": 10,
  "zip_url": "https://supabase.nextprotocol.fr/storage/v1/object/public/dataset/uuid/mon-dataset.zip",
  "additional_info": {
    "from_origin": "toolskit",
    "requested_by": "user-123",
    "metadata": {}
  },
  "images": [
    {
      "filename": "001.jpg",
      "url": "https://supabase.nextprotocol.fr/storage/v1/object/public/dataset/uuid/001.jpg",
      "caption": "a photo of ohwx man in casual",
      "resolution": {
        "width": 1024,
        "height": 768
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

Formulaire multipart avec les images et métadonnées du dataset

​
subject
string
required

Mot-clé du sujet utilisé dans les captions

Example:

"ohwx"

​
name
string
required

Nom du dataset

Example:

"mon-dataset"

​
description
string
required

Description du dataset

Example:

"Dataset de photos portrait"

​
gender
enum<string>
required

Genre du sujet

Available options:
man,
woman
Example:

"man"

​
captions
string[]
required

Liste des captions (une par image, même ordre)

​
images
file[]
required

Fichiers images (JPEG, PNG, WebP, HEIC)

​
additional_info
string
default:{}

JSON string contenant les informations complémentaires : from_origin, requested_by, metadata

Example:

"{\"from_origin\": \"toolskit\", \"requested_by\": \"user-123\", \"metadata\": {}}"

Response

200 - application/json

Dataset créé avec succès

​
id
string

Identifiant unique du dataset (UUID)

​
subject
string

Mot-clé du sujet

Example:

"ohwx"

​
name
string

Nom du dataset

Example:

"mon-dataset"

​
description
string

Description du dataset

Example:

"Dataset de photos portrait"

​
gender
enum<string>

Genre du sujet

Available options:
man,
woman
​
image_count
integer

Nombre d'images dans le dataset

Example:

10

​
zip_url
string

URL publique du ZIP contenant toutes les images et captions

Example:

"https://supabase.nextprotocol.fr/storage/v1/object/public/dataset/uuid/mon-dataset.zip"

​
additional_info
object

Informations complémentaires

​
images
object[]

Liste détaillée des images uploadées