Skip to main content
All API requests require a Bearer token in the Authorization header.

​
API Key

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lucid.foundation/v1/passports

​
SDK Authentication

import { LucidAI } from "raijin-labs-lucid-ai";

const lucid = new LucidAI({
  bearerAuth: process.env.LUCID_API_KEY,
});

​
Owner Address Header

For passport ownership operations, include the X-Owner-Address header: 
// The owner address links passports to a Solana wallet
const passport = await lucid.passports.create({
  name: "my-model",
  type: "model",
}, {
  headers: { "X-Owner-Address": "YOUR_SOLANA_ADDRESS" }
});

​
Base URL

EnvironmentURL
Productionhttps://api.lucid.foundation
Staginghttps://staging.api.lucid.foundation
Never expose your API key in client-side code. Use environment variables or a backend proxy.

​
Rate Limits

See Rate Limits for detailed information.