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