Come ottengo una chiave API e chiamo l'API?
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.
- Apri Settings, poi Claude.
- Scegli Use a personal key instead (usa invece una chiave personale).
- Dagli un Name of the key (nome della chiave) e scegli Create a personal key (crea una chiave personale).
- Copia la chiave. Viene mostrata una sola volta.
Per provarla:
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.
Trova ogni rotta #
Il riferimento completo è un unico documento OpenAPI pubblico a https://app.filmsquare.ai/v1/openapi.json. Vedi il
riferimento OpenAPI per come leggerlo, e la
panoramica dell'API 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.