vercel/ai · error

AI Gateway client secrets must be minted server-side: mintin

Error message

AI Gateway client secrets must be minted server-side: minting needs your Gateway credential, which must never reach the browser. Call gateway.experimental_realtime.getToken() or gateway.experimental_transcription.getToken() from your server and pass the returned token to the client.

What it means

Error "AI Gateway client secrets must be minted server-side: minting needs your Gateway credential, which must never reach the browser. Call gateway.experimental_realtime.getToken() or gateway.experimental_transcription.getToken() from your server and pass the returned token to the client." thrown in vercel/ai.

Source

Thrown at packages/gateway/src/gateway-provider.ts:666

  });

  if (apiKey) {
    return {
      token: apiKey,
      authMethod: 'api-key',
    };
  }

  const oidcToken = await getVercelOidcToken();
  return {
    token: oidcToken,
    authMethod: 'oidc',
  };
}

function assertGatewayClientSecretServerEnvironment(): void {
  if (typeof globalThis.window !== 'undefined') {
    throw new Error(
      'AI Gateway client secrets must be minted server-side: minting needs your Gateway credential, which must never reach the browser. Call gateway.experimental_realtime.getToken() or gateway.experimental_transcription.getToken() from your server and pass the returned token to the client.',
    );
  }
}

View on GitHub (pinned to 69428b1f8b)

When it happens

Trigger: Thrown at packages/gateway/src/gateway-provider.ts:666 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of vercel/ai@69428b1f8b (2026-08-30). Data as JSON: /api/errors/b4b8b38fae43237b. Report an issue: GitHub.