Skip to main content
POST
Python (SDK)

Autorizações

Authorization
string
header
obrigatório

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>.

Cabeçalhos

X-On-Behalf-Of
string

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

Corpo

application/json

Registre um conjunto de dados por referência, ou inicie um upload omitindo a origem.

name
string
obrigatório
source
string | null

Registrar por referência: uma referência opaca a um conjunto de dados externo, ou repo://{repo}[@{revision}][/{path}] (reservado para o armazenamento de conjuntos de dados versionados; os jobs ainda não conseguem resolver fontes repo://). Omitir para fazer upload dos dados em vez disso.

Resposta

Resposta Bem-Sucedida

Um conjunto de dados de treinamento de primeira classe: uma referência registrada ou um conjunto de objetos enviado e confirmado.

created_at
string<date-time>
obrigatório
id
string
obrigatório
kind
enum<string>
obrigatório

Como os dados são obtidos: uma referência externa opaca que o treinador resolve por conta própria, um objeto enviado e disponibilizado ao treinador por meio de uma URL de busca pré-assinada gerada na transferência do provedor, ou uma referência repo:// reservada para o armazenamento de conjuntos de dados versionados.

Opções disponíveis:
external,
upload,
repo
name
string
obrigatório
size_bytes
integer
obrigatório

Bytes totais comprometidos; 0 para referências e uploads não comprometidos.

status
enum<string>
obrigatório

pending_upload até que um conjunto de dados carregado seja confirmado; excluindo enquanto a remoção assíncrona do objeto está em andamento.

Opções disponíveis:
pending_upload,
ready,
deleting
manifest
DatasetManifest · object | null

Registro imutável dos objetos de um conjunto de dados enviado, gravado uma única vez no commit.

revision
string | null

A revisão fixada analisada de uma origem repo://; caso contrário, nulo.

source
string | null

A referência de origem registrada para conjuntos de dados externos e de repositório; nula para envios.

upload
DatasetUpload · object | null

Alvos de upload pré-assinados para um conjunto de dados no modo de upload.