> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gizmo.antimlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication & Teams

> Create a key, choose Personal or Team, and see which features each key can use.

## Base URL

```text theme={null}
https://api.gizmo.antimlabs.com/v1
```

Personal and Team keys use the same base URL. The key decides which asset library and which credit balance a request uses.

## Create a key

In Gizmo, select **Personal** or your **Team**, open **API Access**, and create a key. Send it on every request:

```text theme={null}
Authorization: Bearer gzm_k1_YOUR_KEY
```

Check that it works:

```bash theme={null}
curl --fail-with-body "https://api.gizmo.antimlabs.com/v1/whoami" \
  -H "Authorization: Bearer $GIZMO_API_KEY"
```

Keep keys on your server or in environment variables. Do not put them in browser code or commit them to source control. You can revoke a key at any time in **API Access**.

## Personal or Team

A **Personal** key uses your own library and credits. A **Team** key uses the Team's shared library and the Team's billing. Some field names and error codes call a Team a `workspace`.

| Feature | Personal key | Team key |
| - | - | - |
| Generate assets, variations, reference uploads | Yes | Yes |
| Batches | Up to 50 items per batch | Larger batches |
| Poll, cancel and list jobs and assets | Yes | Yes |
| Export to USD, USDZ, MJCF, SDF, GLB | Yes | Yes, as enabled for the Team |
| Live job events (SSE), `GET /v1/usage`, delete an asset | Yes | Not yet |
| Saved-file download links, export-only retry, collision edits | No | Yes, when enabled for the Team |

> [!NOTE]
>
> With a Team key, live job events, `GET /v1/usage` and `DELETE /v1/assets/{id}` return `403 workspace_route_unavailable`. That means the feature is not available for Teams yet, not that the key is wrong. Do not retry it; poll for progress and check the balance on the Team's Billing page.

[Endpoint reference](https://docs.gizmo.antimlabs.com/api-reference/account/current-user-info.md) · [Generate your first asset](https://docs.gizmo.antimlabs.com/api-generate.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.