Guides/Your first Latentface API call
Quickstart

Your first Latentface API call

Get an API key, install the Python or TypeScript SDK, and make your first Latentface face-embedding call in under three minutes.

By Latentface TeamUpdated

Requirements

  • Free Latentface account (no credit card)
  • Python 3.9+ or Node 18+

Steps

1

Create your account and copy your key

Sign up at latentface.net. Confirm your email, open the dashboard, and copy your key from API Keys → Default. Free-tier keys work immediately with 100 calls/day.

Tip: Keep your key in an env var. Never commit it to a repo.
2

Install the SDK

Python: `pip install latentface`. TypeScript: `npm install @latentface/sdk`. Both SDKs expose the same call surface.

3

Authenticate

The SDK reads `LATENTFACE_API_KEY` from the environment automatically, or pass `api_key="lf_..."` to the client constructor.

4

Make your first call

Call `client.embed(image="./face.jpg")` — the response is a 512-dim float32 vector you can store in any vector DB.

Tip: Every endpoint has a runnable curl example in the docs if you prefer to inspect the raw response first.
5

Check your usage

The dashboard shows per-key call counts, p50/p95 latency, and the current billing-cycle spend. Export to CSV any time.

Ready to go live?

Start your first Latentface session for free — no credit card required.