AIサービスの機能をすぐに体験できるように、モデル設定の確認、API Keyの作成、モデルの呼び出し の3つの手順をご紹介します。
機能の概要
本記事では、AIサービスの基本設定を完了し、APIまたはSQLを使用してモデル呼び出し機能を検証する方法について説明します。
前提条件
OceanBase Cloudコンソールにログインし、左側のナビゲーションバーのAIサービスをクリックして、AIサービスページにアクセスしていること。
SQLを使用してモデルを呼び出す場合は、対象データベースがAI Functionの使用条件を満たしており、対応する権限を持っていることを確認してください。詳細については、AI Functionの組み込みモデルの有効化を参照してください。
API Keyの作成
ガイドカードで、API Keyの下の作成をクリックして、API Key画面に移動します。
API Keyの作成をクリックし、ポップアップウィンドウで、2～64文字の名前を入力します。名前に使用可能なのは漢字、数字、英字、アンダースコア、ハイフンのみです。入力後に利用規約に同意し、関連リスクを理解しましたにチェックを入れます。
OKをクリックし、生成されたAPI Keyをコピーして保存します。
説明
作成後、完全なAPI Keyは一度だけ表示されます。速やかにコピーして適切に保管してください。その後、完全な内容を再表示することはできません。
モデル設定の確認
AIサービスページに戻り、ガイドカードで、モデル設定の確認の下の設定に進むをクリックして、設定ページに移動します。
モデルページで、異なるタスクタイプに応じて必要に応じてデフォルトモデルを選択します。詳細については、組み込みモデル一覧を参照してください。
デフォルトモデル説明テキスト生成 対話生成、コンテンツ作成、Q&Aなどのシナリオに使用されます。 テキスト埋め込み テキストをベクトルに変換するために使用され、意味検索や類似度計算などのシナリオに適しています。 テキスト再ソート 召回結果の関連性に基づいて再ソートし、検索結果の品質を向上させます。 マルチモーダル埋め込み 画像やテキストなどのマルチモーダルコンテンツをベクトルに変換するために使用され、クロスモーダル検索などのシナリオに適しています。 マルチモーダル再ソート マルチモーダル召回結果を再ソートし、マルチモーダル検索の効果を向上させます。 設定を保存します。
完了後、今後のアプリケーション呼び出しやデータベース呼び出しでは、これらのデフォルトモデルを優先的に使用でき、重複する設定作業を削減できます。
モデルの呼び出し
モデル設定とAPI Keyの作成が完了したら、以下の2つの方法でモデルを呼び出すことができます：
APIによるモデル呼び出し
アプリケーションサービス、バックエンドシステム、または外部連携シナリオに適しています。
AIサービスのガイドカードで、モデル呼び出しエリアを確認します。
APIによるモデル呼び出しをクリックします。
ページの例に従って、API Keyを使用してHTTPリクエストを発行し、モデルを呼び出します。
詳細については、AI API一覧を参照してください。
curl -X POST ttps://ai-api-g.oceanbase.com/api/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を使用し、テキスト生成、埋め込み、再順序付けなどを行うシナリオに適しています。
モデル呼び出しエリアで、SQLによるモデル呼び出しをクリックします。
ページの例に従って、データベース内で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の使用量が増加し始めていないか確認します。