Skip to main content
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

dataset_id
string
requerido

Respuesta

Respuesta Exitosa

Un conjunto de datos de entrenamiento de primera clase: una referencia registrada o un conjunto de objetos cargado y confirmado.

created_at
string<date-time>
requerido
id
string
requerido
kind
enum<string>
requerido

Cómo se obtiene el dato: una referencia externa opaca que el entrenador resuelve por sí mismo, un objeto cargado y servido al entrenador mediante una URL de obtención prefirmada emitida en la transferencia al proveedor, o una referencia repo:// reservada para el almacén de conjuntos de datos versionados.

Opciones disponibles:
external,
upload,
repo
name
string
requerido
size_bytes
integer
requerido

Bytes comprometidos totales; 0 para referencias y cargas no comprometidas.

status
enum<string>
requerido

pendiente de carga hasta que un conjunto de datos cargado se confirme; eliminación mientras la eliminación asíncrona de objetos está en curso.

Opciones disponibles:
pending_upload,
ready,
deleting
manifest
DatasetManifest · object | null

Registro inmutable de los objetos de un conjunto de datos cargado, escrito una sola vez al confirmar.

revision
string | null

La revisión fijada analizada desde una fuente repo://; nulo en caso contrario.

source
string | null

La referencia de origen registrada para conjuntos de datos externos y del repositorio; nulo para las cargas.

upload
DatasetUpload · object | null

Objetivos de carga prefirmados para un conjunto de datos en modo de carga.