> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 发现模型（AI SDK）

> 如何获取可供 AI SDK 提供程序使用的最新模型 ID。

Vercel AI SDK 提供程序没有内置的 `listModels()` 辅助方法。可以使用以下任一方式保持模型 ID 为最新状态。

## 方式 1：从 Gateway API 获取

```ts theme={null}
const response = await fetch("https://api.phaseo.app/v1/models", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.PHASEO_API_KEY}`,
  },
});

const filteredResponse = await fetch(
  "https://api.phaseo.app/v1/models?provider=anthropic&status=active,deprecated&availability=all",
  {
    headers: {
      Authorization: `Bearer ${process.env.PHASEO_API_KEY}`,
    },
  },
);

if (!response.ok || !filteredResponse.ok) {
  throw new Error("Failed to load models");
}

const models = await response.json();
const filteredModels = await filteredResponse.json();
console.log(models, filteredModels);
```

## 方式 2：使用官方 TypeScript SDK

```ts theme={null}
import Phaseo from "@phaseo/sdk";

const client = new Phaseo({ apiKey: process.env.PHASEO_API_KEY! });
const models = await client.getModels({
  provider: ["anthropic"],
  status: ["active", "deprecated"],
  availability: "all",
});

console.log(models);
```

## 在 AI SDK 中使用发现的 ID

```ts theme={null}
import { phaseo } from "@phaseo/ai-sdk-provider";
import { generateText } from "ai";

const result = await generateText({
  model: phaseo("openai/gpt-5-nano"),
  prompt: "Hello from a discovered model ID.",
});

console.log(result.text);
```

## 备注

* 模型 ID 使用 `provider/model` 格式。
* `/v1/models` 支持 `provider`、`status`、`organisation`、`endpoints` 和 `availability` 等筛选条件。
* 定期重新检查模型可用性，以跟进路由变更和弃用信息。
* 建议从 `/v1/models` 选择 ID，避免长期在代码中硬编码。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.