
# v7: Vertex AI (Gemini) $  ðÙ

t FreeeÐ p˜ ´íD 1õ<\  8,  ˆŒ ÈµÈä. äL èÄ” GoogleX **Vertex AI**| ¬©Xì  p˜| Ù<\ tLà¬Ä\ „XX” AI 0¥D ” X” ƒ…Èä.

tˆ ì¤¸Ð” Vertex AI| $Xà, TypeScriptÐ Gemini ¨xD ¬©Xì p˜ ´íD „X” 0ø lp| ÌíÈä.

## 1èÄ: Google Cloud \¸ Ux

Vertex AI| ¬©X$t Google Cloud \¸  D”iÈä. v2Ð Google Sheets API| \1T` L Ý1\ D¤ ÄD ø \ ¬©`  ˆµÈä.

D¤ Ä ¤ |(`credentials/freee-sheets-service-key.json`)D UxXì \¸ ID| >µÈä:

```bash
cat credentials/freee-sheets-service-key.json | grep "project_id"
```

œ% Ü:
```json
"project_id": "spatial-cargo-456805-u2"
```

t \¸ ID| 0µtP8”.

## 2èÄ: Vertex AI API \1T  Billing $

1. **Vertex AI API \1T**:
   - Google Cloud ConsoleÐ https://console.cloud.google.com/apis/library/aiplatform.googleapis.com )8
   - \¸|  ÝXà "¬© $" t­

2. **Billing \1T** (D):
   - Vertex AI”  Ì APItÀ\ Billing ÄD ð°t| iÈä
   - https://console.cloud.google.com/billing Ð Billing \1T
   - 4Ì l't ˆ” ½° ¬©  ¥

## 3èÄ: Vertex AI SDK $X

\¸Ð Vertex AI SDK| $XiÈä:

```bash
npm install @google-cloud/vertexai
```

## 4èÄ: `.env` | Åpt¸

`.env` |Ð D¤ Ä ¤ ½\| ” iÈä (tø ˆät Ux):

```ini
# .env |
...
GOOGLE_SERVICE_ACCOUNT_KEY_PATH="./credentials/freee-sheets-service-key.json"
```

## 5èÄ: Vertex AI t|t¸¸ Ý1

`src/vertexAiClient.ts` |D Ý1Xì Vertex AI ðÙ \ÁD liÈä:

```typescript
// src/vertexAiClient.ts
import { VertexAI } from '@google-cloud/vertexai';
import * as path from 'path';
import * as dotenv from 'dotenv';

dotenv.config();

const GOOGLE_SERVICE_ACCOUNT_KEY_PATH = process.env.GOOGLE_SERVICE_ACCOUNT_KEY_PATH;

if (!GOOGLE_SERVICE_ACCOUNT_KEY_PATH) {
  throw new Error('X½ À GOOGLE_SERVICE_ACCOUNT_KEY_PATH  $À JXµÈä.');
}

// Google Cloud \¸ $
const PROJECT_ID = 'spatial-cargo-456805-u2'; // ä \¸ ID\ À½
const LOCATION = 'asia-northeast1'; // \m/|øÐ  ¥  L´ ¬

// Vertex AI 0T
const vertexAI = new VertexAI({
  project: PROJECT_ID,
  location: LOCATION,
  googleAuthOptions: {
    keyFilename: path.resolve(GOOGLE_SERVICE_ACCOUNT_KEY_PATH),
  },
});

// Gemini ¨x $
const model = vertexAI.getGenerativeModel({
  model: 'gemini-2.5-pro', // \à Gemini ¨x
});

console.log(' Vertex AI t|t¸¸  0TÈµÈä.');
```

## 6èÄ: è\ L¤¸

Vertex AI ðÙt  \ È”À UxX0 t è\ L¤¸ h| ” iÈä:

```typescript
// src/vertexAiClient.ts XèÐ ” 

export const testVertexAI = async () => {
  try {
    const prompt = 'HUX8”! 1+1@ 4Çx ”?';

    const result = await model.generateContent(prompt);
    const response = result.response;
    const text = response.candidates?.[0]?.content?.parts?.[0]?.text || '';

    console.log('Vertex AI Qõ:', text);
    return text;
  } catch (error: any) {
    console.error('L Vertex AI L¤¸ ä(:', error.message);
    throw error;
  }
};
```

## 7èÄ: L¤¸ ä‰

`src/index.ts`Ð Vertex AI ðÙD L¤¸iÈä:

```typescript
// src/index.ts
import { testVertexAI } from './vertexAiClient';

const main = async () => {
  console.log('>ê Vertex AI ðÙ L¤¸ Ü‘...\n');

  try {
    await testVertexAI();
    console.log('\n Vertex AI ðÙ 1õ!');
  } catch (error: any) {
    console.error('\nL $X Ý:', error.message);
  }
};

main().catch(error => {
  console.error('´ ä‰  $X Ý:', error);
  process.exit(1);
});
```

¤l½¸| ä‰iÈä:

```bash
npx ts-node src/index.ts
```

Á œ%:
```
>ê Vertex AI ðÙ L¤¸ Ü‘...

 Vertex AI t|t¸¸  0TÈµÈä.
Vertex AI Qõ: HUX8”! 1+1@ 2…Èä.

 Vertex AI ðÙ 1õ!
```

## üX¬m

- **D©**: Vertex AI” ¬©ÉÐ 0| ü)Èä. L¤¸ èÄÐ” D©t pX ÝXÀ JÀÌ, \UXÐ” API 8œ Ÿ| \Tt| iÈä.
- **Region**: `asia-northeast1` (ÄÄ)D ¬©Xt \m/|øÐ  ¥ `x Qõ Ä| »D  ˆµÈä.
- **¨x  Ý**: `gemini-2.5-pro`”  ¥ \àtà %\ ¨xtÀÌ, D©t ’µÈä. è\ „X ‘ÅÐ” `gemini-1.5-flash`| ¬©X” ƒt T ½|  ˆµÈä.

---

äL **v8** ì¤¸Ð” Vertex AI| ¬©Xì Freee p˜ ´íD ä\ tLà¬Ä\ Ù „XX” 0¥D lX µÈä.