Skip to main content
POST
Démarrer un téléversement JSONL vers un dataset

Autorisations

Authorization
string
header
requis

Une clé API wandb ou un JWT wandb. Les sessions du navigateur sont échangées par le backend de l’application web Model Distillation ; les capacités des tâches sont réservées à un usage interne.

En-têtes

Wandb-Entity
string

entity personnel ou d’équipe accessible. Omettez ce champ pour utiliser l’entity par défaut de l’utilisateur authentifié.

Paramètres de chemin

alias
string
requis
Pattern: ^[a-z0-9-]{1,64}$
datasetId
string<uuid>
requis

Corps

application/json
idempotency_key
string
requis

Répéter une requête avec la même clé renvoie le même téléversement.

Required string length: 1 - 128
file
object
requis
mode
enum<string>
défaut:append

append rejette les lignes dont le row_id existe déjà ; upsert les remplace.

Options disponibles:
append,
upsert

Réponse

La session de téléversement.

id
string<uuid>
requis
dataset_id
string<uuid>
requis
mode
enum<string>
requis
Options disponibles:
append,
upsert
state
enum<string>
requis

uploading jusqu’à l’appel de complete ; queued et validating pendant que le worker vérifie chaque ligne ; committed une fois les lignes intégrées au dataset.

Options disponibles:
uploading,
queued,
validating,
committed,
failed,
cancelled,
expired
error
string | null
requis
counters
object | null
requis

Après l'enregistrement : rows, created, updated, revision, et entry_counts.

expires_at
string<date-time>
requis
file
object
requis
upload
object | null
requis

Destination du fichier tant que le téléversement est en cours ; null après l’appel à complete.

validation
object
requis
created_at
string<date-time>
requis
updated_at
string<date-time>
requis
Dernière modification le 8 octobre 2026