快速上手

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

功能说明

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

前提条件

• 您已登录 OB Cloud 云数据库控制台，并单击左侧导航栏 AI 服务进入 AI 服务页面。

• 如果您计划通过 SQL 调用模型，请确认目标数据库已具备 AI Function 使用条件，并拥有对应权限。更多内容参见 开启 AI Function 内置模型 。

创建 API Key

1. 在引导卡片中，单击 API Key 下的单击去创建，进入 API Key 页面。

2. 单击创建 API Key，在弹出框中输入名称，长度为 2~64 字符，只能包含中文、数字、英文字母、下划线、短横线并勾选我已同意协议并知悉相关风险。

3. 单击确定，复制并保存生成的 API Key。

确认模型配置

1. 返回 AI 服务页面，在引导卡片中，单击 确认模型配置 下的 去配置，进入配置页面。

2. 在模型页面中，为不同任务类型按需选择默认模型，详情请参见 内置模型列表。

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

3. 保存配置。

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

调用模型

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

API 调用模型

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

1. 在 AI 服务引导卡片中，查看 调用模型 区域。

2. 单击 API 调用模型。

3. 按页面示例使用 API Key 发起 HTTP 请求调用模型。

   更多内容请参见 AI API 列表。

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 模型。

完成验证

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

• 通过 API 调用模型，确认能够正常返回结果。

• 通过 SQL 调用模型，确认 AI Function 可以正常执行。

• 在 AI 服务概览页查看 Token 用量是否开始增长。