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

name
string
requerido

Respuesta

Respuesta Exitosa

Un tipo de acelerador ofrecido en el catálogo.

class
enum<string>
requerido

Clase de acelerador grueso. npu/tpu están reservados para futuras entradas del catálogo.

Opciones disponibles:
gpu,
cpu
max_count
integer
requerido

Máximo de aceleradores de este tipo por réplica. Para la clase cpu, la unidad es vCPU: el número máximo de vCPU que se pueden alquilar por réplica.

name
string
requerido
Ejemplo:

"H100"

placements
enum<string>[]
requerido

Ubicaciones donde existe este acelerador. Todas las entradas del catálogo son externas (adquiridas en el marketplace) actualmente; las internas llegan con inventario de clúster privado.

Opciones disponibles:
internal,
external
vendor
string
requerido
Ejemplos:

"nvidia"

"amd"

"intel"

"aws"

workload_affinity
AcceleratorWorkloadAffinity · object
requerido

Valoraciones de idoneidad por carga de trabajo para un tipo de acelerador, basadas en la matriz de hardware de entrenamiento.

acquirability
enum<string>

Estimación por bandas de cuán confiablemente se puede adquirir la capacidad de coincidencia, calculada a partir del historial de disponibilidad. "desconocido" significa que no hay historial, nunca una suposición.

Opciones disponibles:
high,
medium,
low,
unknown
acquirable_count
integer

Configuraciones adquiribles ahora (0 cuando offered es falso). Ausente cuando no hay datos de mercado en tiempo real.

kind
enum<string>
predeterminado:gpu
obsoleto

Obsoleto: use class. Se mantiene por compatibilidad con el SDK hasta la próxima revisión de convenciones incompatibles.

Opciones disponibles:
gpu,
npu,
tpu,
other
memory_gb
integer

Memoria por acelerador en GB. Ausente para la clase cpu: la capacidad de CPU se dimensiona por solicitud (min_vcpus/min_mem_gb), no mediante un módulo fijo.

offered
boolean

Si alguna capacidad adquirible ahora coincide con este tipo. Ausente cuando los datos de mercado en vivo no están disponibles.

price_usd_hr
AcceleratorPriceBand · object

Banda de precios en USD por hora a través de configuraciones adquiribles ahora para un tipo de acelerador.