---
title: "快速上手 - OB Cloud 云数据库 master | OceanBase 文档中心"
description: 快速上手 为您介绍 确认模型配置 、 创建 API Key 和 调用模型 三个步骤，待您快速体验 AI 服务能力。 功能说明 通过本文，您可以完成 AI 服务的基础初始化，并通过 API 或 SQL 方式验证模型调用能力。 前提条件 您已登录 OB Cloud 云数据库控制台，并单击左侧导航栏 AI 服务 进入 AI…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库

# 快速上手

更新时间：2026-06-21 08:56:52

为您介绍 **确认模型配置**、**创建 API Key** 和 **调用模型** 三个步骤，待您快速体验 AI 服务能力。

## 功能说明

通过本文，您可以完成 AI 服务的基础初始化，并通过 API 或 SQL 方式验证模型调用能力。

## 前提条件

- 您已登录 OB Cloud 云数据库控制台，并单击左侧导航栏 **AI 服务**进入 AI 服务页面。
 - 如果您计划通过 SQL 调用模型，请确认目标数据库已具备 AI Function 使用条件，并拥有对应权限。更多内容参见 [开启 AI Function 内置模型](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000004295544) 。

## 创建 API Key

1. 在引导卡片中，单击 **API Key** 下的单击**去创建**，进入 API Key 页面。
 2. 单击**创建 API Key**，在弹出框中输入名称，长度为 2~64 字符，只能包含中文、数字、英文字母、下划线、短横线并勾选**我已同意协议并知悉相关风险**。
 3. 单击**确定**，复制并保存生成的 API Key。

#### 说明

创建成功后，完整的 API Key 仅会展示一次，请及时复制并妥善保存，后续无法再次查看完整内容。

## 确认模型配置

1. 返回 AI 服务页面，在引导卡片中，单击 **确认模型配置** 下的 **去配置**，进入配置页面。
 2. 在模型页面中，为不同任务类型按需选择默认模型，详情请参见 [内置模型列表](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000005767006)。

   | 默认模型 | 说明 |
   | --- | --- |
   | 文本生成 | 用于对话生成、内容创作、问答等场景。 |
   | 文本嵌入 | 用于将文本转换为向量，适用于语义检索、相似度计算等场景。 |
   | 文本重排序 | 用于对召回结果进行相关性重排，提升检索结果质量。 |
   | 多模态嵌入 | 用于将图片、文本等多模态内容转换为向量，适用于跨模态检索等场景。 |
   | 多模态重排序 | 用于对多模态召回结果进行重排序，提升多模态检索效果。 |
 3. 保存配置。

完成后，后续应用调用或数据库调用可优先使用这些默认模型，减少重复配置工作。

## 调用模型

完成模型配置和 API Key 创建后，您可以通过以下两种方式调用模型：

### API 调用模型

适用于应用服务、后端系统或外部集成场景。

1. 在 AI 服务引导卡片中，查看 **调用模型** 区域。
 2. 单击 **API 调用模型**。
 3. 按页面示例使用 API Key 发起 HTTP 请求调用模型。

   更多内容请参见 [AI API 列表](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000005766994)。

```
curl -X POST https://ai-api-cn.oceanbase.com/v1/chat/completions \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"model": "qwen3-max", "messages": [{"role": "user", "content": "Hello"}]}'

```

### SQL 调用模型

适用于在数据库内部直接使用 AI Function 进行文本生成、嵌入和重排序等场景。

1. 在 **调用模型** 区域中，单击 **SQL 调用模型**。
 2. 根据页面示例，在数据库中使用 AI Function 调用模型。

```
  SELECT AI_COMPLETE("ob_complete","How are you") AS ans;
  SELECT AI_EMBEDDING("ob_embed","I am OceanBase Cloud AI") AS embedding;
  SELECT AI_RERANK("ob_rerank1","Apple",["apple","banana","fruit","vegetable"]) AS rerank_result;

```

如果您需要在数据库中注册 AI 模型，也可以在模型页面中生成数据库注册 SQL 后再进行调用。更多内容请参见 [使用 AI 模型](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000005766991)。

## 完成验证

完成以上步骤后，可通过以下方式验证是否接入成功：

- 通过 API 调用模型，确认能够正常返回结果。
 - 通过 SQL 调用模型，确认 AI Function 可以正常执行。
 - 在 AI 服务概览页查看 Token 用量是否开始增长。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线