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:47

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): an owner of the Google Cloud project gives Showreel Studio's service account the Vertex AI User role there. 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. The message that asks for the grant names the service account. It is still your project and your bill.

What next