Getting started

The TensorTensor API has two operations on the build resource: submit a job, and check status.

All requests authenticate with your API key in the X-TensorTensor-API-Key: <key> header. Get a key at app.tensortensor.com.

Submit a build job

POST https://api.tensortensor.com/api/v1/build

Body

Field	Type	Required	Notes
email	string	yes	Where the completion link is sent.
vectorsUrl	string	yes	Publicly reachable HTTPS URL to a float32 vector file.
dimensions	number	yes	One of 768, 1024, 1536.

Example

curl -X POST https://api.tensortensor.com/api/v1/build \
  -H "X-TensorTensor-API-Key: key-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "vectorsUrl": "https://your.cdn/vectors.bin",
    "dimensions": 768
  }'

If you don’t have a vectors file yet, a 1k x 768d sample is hosted publicly at https://raw.githubusercontent.com/TensorTensorCom/examples/main/data/sample-1k-768d.bin (use dimensions: 768).

Response

{
  "data": {
    "jobId": "bld_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "received"
  }
}

Check job status

GET https://api.tensortensor.com/api/v1/build/:jobId

Example

curl https://api.tensortensor.com/api/v1/build/bld_xxx \
  -H "X-TensorTensor-API-Key: key-xxxxxxxxxxxx"

Response (in progress)

{
  "data": [{
    "jobId": "bld_xxx",
    "status": "queued",
    "submittedAt": "2026-04-26T18:46:16.000Z"
  }]
}

Response (complete)

{
  "data": [{
    "jobId": "bld_xxx",
    "status": "complete",
    "submittedAt": "2026-04-26T18:46:16.000Z",
    "completedAt": "2026-04-26T19:14:02.000Z",
    "downloadUrl": "https://...hnsw",
    "vectors": 100000,
    "dimensions": 768,
    "fileSize": 524288000,
    "memoryRequired": 629145600
  }]
}

When status is complete, use downloadUrl to fetch the HNSW file. See Loading your index.

Status values

Status	Meaning
received	Job accepted, queued for intake.
validating	URL is being checked for reachability and integrity.
queued	Validated, waiting for a GPU build slot.
building	Index is being built on a GPU.
built	Index built, finalizing (uploading, sending email).
complete	Done. downloadUrl is set.
failed	Job failed. error is set.