# Quickstart

Great Work Labs hosts 27 small models, each built for one job. You call them over HTTP with an API key and pay per call from a prepaid balance.

## 1. Get a key

[Sign in](https://labs.greatwork.company/login) with your email, add credit (from $5) on the [billing page](https://labs.greatwork.company/dashboard/billing), and create a key on the [keys page](https://labs.greatwork.company/dashboard/keys). Keys start with `gwl_` and are shown once.

```bash
export GWL_API_KEY=gwl_...
```

## 2. Call a model

Every model takes the same request: the model id, an `input`, and any options.

```bash
curl https://labs.greatwork.company/v1/run \
  -H "Authorization: Bearer $GWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "sieve-1", "input": "You are an idiot."}'
```

```json
{
  "id": "run_7Qd2...",
  "object": "run",
  "model": "sieve-1",
  "created": 1763510400,
  "output": {
    "flagged": true,
    "labels": [
      "toxicity",
      "insult"
    ],
    "scores": {
      "toxicity": 0.9095,
      "insult": 0.9069,
      "...": "..."
    }
  },
  "usage": {
    "units": 1,
    "unit": "text",
    "cost_usd": "0.00002",
    "cost_micros": 20
  },
  "latency_ms": 38
}
```

## 3. Batch

Text models take an array of up to 64 inputs (128 for embeddings). One request, one price per item, outputs in the same order.

```bash
curl https://labs.greatwork.company/v1/run -H "Authorization: Bearer $GWL_API_KEY" -H "Content-Type: application/json" \
  -d '{"model": "lingo-1", "input": ["Merci beaucoup", "Vielen Dank", "ありがとう"]}'
```

## 4. Images and audio

Send a URL, a data URL, or upload the file with multipart:

```bash
curl https://labs.greatwork.company/v1/run -H "Authorization: Bearer $GWL_API_KEY" -F model=ink-1 -F input=@receipt.jpg
```

## JavaScript and Python

```js
const res = await fetch("https://labs.greatwork.company/v1/run", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.GWL_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "veil-1", input: "Email me at dana@example.com", redact: "type" }),
});
const { output } = await res.json(); // output.redacted === "Email me at [EMAIL]"
```

```python
import os, requests
r = requests.post("https://labs.greatwork.company/v1/run",
    headers={"Authorization": f"Bearer {os.environ['GWL_API_KEY']}"},
    json={"model": "tone-1", "input": "Arrived early and works great."})
print(r.json()["output"]["label"])  # positive
```

A single-file TypeScript client with types for every model is at [https://labs.greatwork.company/sdk/labs.ts](https://labs.greatwork.company/sdk/labs.ts) and a Python one at [https://labs.greatwork.company/sdk/labs.py](https://labs.greatwork.company/sdk/labs.py). Copy them into your project; they have no dependencies.

## Next

- [All models](https://labs.greatwork.company/models) and the [playground](https://labs.greatwork.company/playground)
- [API reference](https://labs.greatwork.company/docs/api): errors, idempotency, rate limits, usage, estimates
- [For agents](https://labs.greatwork.company/docs/agents): MCP, llms.txt, prompts for coding agents
- [OpenAI-compatible endpoints](https://labs.greatwork.company/docs/openai)
