本記事では、AI APIを使用してOB CloudのAIサービスにアクセスする方法について説明します。AI APIはOpenAI、Anthropic、Vertex AIと互換性のある呼び出し方式を提供しており、既存のアプリケーションで使用されているインターフェースプロトコル、リクエストフォーマット、アクセス習慣に応じて対応するインターフェースを選択し、既存の呼び出しロジックを再利用することで、モデルのアクセスと連携テストを迅速に完了できます。
前提条件
ご自身がAIサービスを有効にしていること。
利用可能な
API Keyを作成済みであること。詳細については、AI API Keyの管理をご参照ください。
呼び出し方式
AI APIはHTTPリクエストによる呼び出しをサポートしています。
API Keyをインターフェース要件に従ってAuthorizationヘッダーに設定します。一般的な呼び出し例は以下のとおりです：
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"}]}'
戻り値の例
- 呼び出しが成功した場合
{
"id": "req_xxx",
"object": "response",
"created": 1710000000,
"model": "example-model",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello, OceanBase Cloud AI."
}
}
]
}
- 呼び出しが失敗した場合
{
"error": {
"code": "unauthorized",
"message": "Invalid API key."
}
}