> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# ![Mastra logo](https://mastra.ai/brand/logo.svg)마스트라

이 게이트웨이는 [Observational Memory](https://gateway.mastra.ai/docs/features#observational-memory)가 내장된 OpenAI 호환 API 프록시입니다. HTTP 클라이언트, SDK 또는 프레임워크가 게이트웨이를 가리키도록 설정하면 Memory 관리 코드를 작성하지 않아도 모든 대화를 자동으로 기억합니다. 자세한 내용은 다음에서 확인하세요.[Gateway documentation](https://gateway.mastra.ai/docs).

## API 키 받기

[gateway.mastra.ai](https://gateway.mastra.ai)로 이동하여 Mastra 계정에 가입하세요. 온보딩 과정에서 요청 인증에 사용할 개인 API 키를 받게 됩니다.

## 용법

API 키를 환경 변수로 정의합니다.

```bash
MASTRA_GATEWAY_API_KEY=your-gateway-key
```

게이트웨이 Model ID를 설정합니다.

```typescript
import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "mastra/openai/gpt-5-mini"
});
```

게이트웨이를 통해 실행되어야 하는 내장 Model에 동일한 접두사를 사용합니다.

```typescript
import { ModelRouterEmbeddingModel } from "@mastra/core/llm";

const embedder = new ModelRouterEmbeddingModel("mastra/openai/text-embedding-3-small");
```

응답을 생성하거나 스트리밍할 때 `memory.thread`와 `memory.resource`를 전달하여 Observational Memory를 활성화하세요.

```typescript
import { weatherAgent } from "./agents/weather-agent";

const memory = {
  thread: "assistant-thread-1",
  resource: "user-42",
};

const result = await weatherAgent.stream("My name is Alex and I prefer concise answers.", {
  memory,
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}
```

## 구성

```bash
# Use gateway API key
MASTRA_GATEWAY_API_KEY=your-gateway-key
```

## 자세히 알아보기

- [특징](https://gateway.mastra.ai/docs/features)
- [Model](https://gateway.mastra.ai/docs/models)
- [제한](https://gateway.mastra.ai/docs/limits)
- [API 참조](https://gateway.mastra.ai/docs/api/overview)
- [예](https://gateway.mastra.ai/docs/examples/)