---
title: "Submit"
method: POST
path: "/api/inference"
tags: ["Inference"]
---

# Submit

`POST /api/inference`

Submit a serverless inference request.

Schedules a short-lived GPU job that runs the specified model on the
provided inputs. Returns a job_id to poll for results.

## Request body

- InferenceRequest
  - `model` string, required — Model name or HuggingFace repo (e.g. 'distilbert-base-uncased-finetuned-sst-2-english')
  - `inputs` union, required — Text input(s) for inference
    - string[]
    - string
  - `gpu_model` string — Preferred GPU model or 'any'
  - `max_tokens` integer
  - `temperature` number
  - `timeout_sec` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aabiro/apis/xcelsior.md) · [All operations](https://skmtc.net/aabiro/apis/xcelsior/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aabiro/xcelsior/versions/b4f5ef136e6a/schema)
