Showreel Studio Help
Help · Getting started

Connect your Google Cloud

The voice-over, voice auditions, your own voices and Gemini writing run on your organisation's own Google Cloud project.

Video Connect your Google Cloud0:54

Every organisation connects its own Google Cloud project. The voice-over runs there and is billed to it; Showreel Studio never spends on its own cloud for you. Without a connection, the voice refuses and says how to make one.

Before you start

  • A Google Cloud project with the Vertex AI API turned on.
  • Your Google account has the Vertex AI User role on it (and Cloud Text-to-Speech too, for your own voice).
  • gcloud is installed and signed in on your Mac (gcloud auth login).

Connect a project

Set it when you create the project folder:

showreel init --cloud-project my-google-project

That writes the connection into the project's showreel.json:

"cloud": { "provider": "vertex", "project": "my-google-project", "location": "us-central1" }

To use the same project for every project on your Mac, put the same cloud object in ~/.showreel/config.json. A project's own setting wins.

Two ways for Showreel Studio to use it

  • Pass-through (the default): your own gcloud sign-in on this Mac is passed along with each voice request, so it runs as you, on your project.
  • Grant ("mode": "grant" in the cloud object): your organisation's own Google identity acts on the project. Then the web app and cloud recordings can voice a film with nobody's sign-in at hand, for example when someone edits the words online. It is still your project and your bill.

Set up grant mode

  1. An owner or admin opens Organisation → Google Cloud in the web app and chooses Set it up, or runs showreel org cloud setup. Your organisation gets a Google identity of its own, such as org-…@showreel-tenants-509811.iam.gserviceaccount.com.
  2. Type your project's id there, then have an owner of the project run the two commands shown. They grant the identity Vertex AI User (the voice and Gemini), and Service Usage Consumer (your own voices, billed to your project).
  3. Set "mode": "grant" in the project's cloud connection.

Only your organisation's calls ever act as this identity. If another organisation named your project, its calls would go as its own identity, which has no role there, so Google refuses them. When your plan ends, the identity is deleted with your material, 30 days later.

What next