Skip to main content
GET
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.

Parâmetros de caminho

name
string
obrigatório

Resposta

Resposta Bem-Sucedida

Um tipo de acelerador oferecido no catálogo.

class
enum<string>
obrigatório

Classe de acelerador grosseiro. npu/tpu são reservados para futuras entradas do catálogo.

Opções disponíveis:
gpu,
cpu
max_count
integer
obrigatório

Máximo de aceleradores desse tipo por réplica. Para a classe cpu, a unidade é vCPUs: o número máximo de vCPUs alugáveis por réplica.

name
string
obrigatório
Exemplo:

"H100"

placements
enum<string>[]
obrigatório

Locais onde este acelerador existe. Todas as entradas do catálogo são externas (adquiridas no marketplace) atualmente; o inventário interno chega com o cluster privado.

Opções disponíveis:
internal,
external
vendor
string
obrigatório
Exemplos:

"nvidia"

"amd"

"intel"

"aws"

workload_affinity
AcceleratorWorkloadAffinity · object
obrigatório

Classificações de adequação por carga de trabalho para um tipo de acelerador, derivadas da matriz de hardware de treinamento.

acquirability
enum<string>

Estimativa em faixas de quão confiavelmente a capacidade correspondente pode ser adquirida, calculada com base no histórico de disponibilidade. "unknown" significa ausência de histórico, nunca um palpite.

Opções disponíveis:
high,
medium,
low,
unknown
acquirable_count
integer

Configurações adquiríveis agora (0 quando oferecido é falso). Ausente quando dados de mercado ao vivo não estão disponíveis.

kind
enum<string>
padrão:gpu
obsoleto

Descontinuado: use class. Mantido por compatibilidade com o SDK até a próxima revisão de convenções com quebra de compatibilidade.

Opções disponíveis:
gpu,
npu,
tpu,
other
memory_gb
integer

Memória por acelerador em GB. Ausente para a classe cpu: a capacidade de CPU é dimensionada por solicitação (min_vcpus/min_mem_gb), não por um módulo fixo.

offered
boolean

Se alguma capacidade adquirível no momento corresponde a este tipo. Ausente quando os dados de mercado ao vivo não estão disponíveis.

price_usd_hr
AcceleratorPriceBand · object

Faixa de preço em USD por hora, entre as configurações adquiríveis agora, para um tipo de acelerador.