---
title: "Come ottengo una chiave API e chiamo l'API?"
description: "Crea una chiave personale in Settings, Claude (qualsiasi ruolo), o una chiave dello spazio di lavoro tramite l'API (produttore e superiori), e mandala come bearer token."
url: https://www.filmsquare.ai/help/it/connect/api-keys/
lang: it
section: connect
updated: 2026-11-13
---

L'app, il tuo Claude e i tuoi script chiamano tutti la stessa API REST, con gli stessi ruoli. Una chiave inizia con
`fsk_`, appartiene a un solo spazio di lavoro e non ha mai più diritti della persona per cui agisce. Mandala come
`Authorization: Bearer <key>` a `https://app.filmsquare.ai/v1`.

## Crea una chiave personale

Una chiave personale funziona per qualsiasi ruolo.

1. Apri **Settings**, poi **Claude**.
2. Scegli **Use a personal key instead** (usa invece una chiave personale).
3. Dagli un **Name of the key** (nome della chiave) e scegli **Create a personal key** (crea una chiave personale).
4. Copia la chiave. Viene mostrata una sola volta.

Per provarla:

```bash
curl -s "https://app.filmsquare.ai/v1/me" -H "Authorization: Bearer $FS_KEY"
```

Una chiave personale può fare ciò che il tuo ruolo consente, tranne gestire le chiavi. Per fermarla, scegli
**Disconnect** (scollega) nella stessa pagina.

## Crea una chiave dello spazio di lavoro

Un produttore o un proprietario può creare chiavi con un ruolo a scelta tramite l'API, anche per un utente agente. Il
ruolo non può mai essere superiore al tuo, e la chiamata deve venire da una sessione con accesso effettuato: una
chiave personale o un collegamento con Claude non possono creare chiavi. La richiesta e le rotte per elencare e
revocare sono nella documentazione sotto [una chiave API dello spazio di lavoro](https://www.filmsquare.ai/docs/it/api/overview/#a-workspace-api-key-producer-and-up).

## Trova ogni rotta

Il riferimento completo è un unico documento OpenAPI pubblico a `https://app.filmsquare.ai/v1/openapi.json`. Vedi il
[riferimento OpenAPI](https://www.filmsquare.ai/docs/it/api/openapi/#reading-the-document) per come leggerlo, e la
[panoramica dell'API](https://www.filmsquare.ai/docs/it/api/overview/#errors-you-will-meet) per gli errori che incontrerai. Per essere avvisato
quando un ciak è pronto invece di interrogare di continuo, vedi [ricevere un webhook quando un ciak è pronto](https://www.filmsquare.ai/help/it/connect/webhooks/).
