Skip to main content
POST
/
v1
/
match
Typescript (SDK)
import { RaijinLabsLucidAi } from "raijin-labs-lucid-ai";

const raijinLabsLucidAi = new RaijinLabsLucidAi();

async function run() {
  const result = await raijinLabsLucidAi.match.compute({
    body: {
      modelMeta: {
        schemaVersion: "1.0",
        modelPassportId: "ppt_model_7xK9mQ2v",
        format: "safetensors",
        runtimeRecommended: "vllm",
        contextLength: 32768,
        requirements: {
          minVramGb: 16,
        },
      },
      policy: {
        policyVersion: "1.0",
        allowRegions: [
          "us-east-1",
        ],
        latency: {
          p95MsBudget: 500,
        },
      },
      computeCatalog: [
        {
          schemaVersion: "1.0",
          computePassportId: "ppt_compute_Xn5vR2kJ",
          providerType: "cloud",
          regions: [
            "us-east-1",
          ],
          hardware: {
            gpu: "NVIDIA-A100-40GB",
            vramGb: 40,
          },
          runtimes: [],
          endpoints: {
            inferenceUrl: "https://ironclad-puritan.biz/",
          },
        },
      ],
    },
  });

  console.log(result);
}

run();
{
  "success": true,
  "match": {
    "compute_passport_id": "ppt_compute_Xn5vR2kJ",
    "score": 0.95,
    "region": "us-east-1"
  },
  "explain": {
    "runtime_compatible": true,
    "hardware_compatible": true,
    "policy_pass": true,
    "latency_ok": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.lucid.foundation/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Lucid API key (lk_live_... or lk_test_...)

Headers

X-Payment-Proof
string

Transaction hash proving USDC payment (x402 protocol)

Body

application/json
model_meta
object

Metadata for a model passport. Validated against schemas/ModelMeta.schema.json (additionalProperties: false).

policy
object
compute_catalog
object[]
require_live_healthy
boolean
default:true

Response

OK

success
boolean
required
match
object
required
explain
object
required