Skip to main content
OpenAI ChatGPT は非常に強力な AI 対話システムであり、プロンプトを入力するだけで、わずか数秒で流暢で自然な応答を生成できます。ChatGPT はその優れた言語理解および生成能力により業界で際立っており、現在ではすでにさまざまな業界や分野で広く利用され、その影響力はますます顕著になっています。日常会話、創作執筆、専門的な相談、コードプログラミングのいずれにおいても、ChatGPT は驚くべきインテリジェントな支援を提供し、人間の作業効率と創造性を大幅に向上させます。 本ドキュメントでは、主に OpenAI Chat Completion API 操作の使用プロセスを紹介します。これを利用することで、公式 OpenAI ChatGPT の対話機能を簡単に使用できます。

GPT-6.1 Sol

model: "gpt-6.1-sol" を使用してこのモデルを選択します。ストリーミング出力、関数呼び出し、構造化出力、画像入力をサポートしています。初回公開から1週間以内は、認証済みの ACE T1+ 保有者(少なくとも 100,000 ACE)または認可されたユーザーのみに公開されます。具体的な公開時期はコンソールのアクセス案内に従います。 推論レベルは low、medium、high、xhigh、max をサポートしており、現時点では none または minimal はサポートしていません。reasoning_effort: "low" から開始することを推奨します。入力が 272,000 tokens を超える場合、リクエスト全体に長文コンテキスト料金が適用され、料金はコンソールの現在の価格に準じます。

申請プロセス

OpenAI Chat Completion API を使用するには、まず Ace Data Cloud コンソール で API Token を取得し、予備として保管してください。 まだログインまたは登録していない場合は、自動的にログインページへ移動し、登録とログインを促されます。完了後は自動的に現在のページへ戻ります。 1つの API Token でプラットフォームのすべてのサービスを呼び出すことができ、サービスごとに個別に申請する必要はありません。 初回申請時には無料枠が付与され、無料で体験できます。枠が不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント:OpenAI Chat Completion API →

基本的な使用方法

続いて、画面上で対応する内容を入力できます。図のように表示されます。

このインターフェースを初めて使用する際には、少なくとも3つの内容を入力する必要があります。1つ目は authorization で、ドロップダウンリストから直接選択できます。もう1つのパラメータは model で、model は使用する OpenAI ChatGPT 公式サイトのモデルカテゴリです。ここでは主に20種類のモデルがあり、詳細は提供しているモデルをご確認ください。最後のパラメータは messages であり、messages は入力する質問文の配列です。これは配列であり、複数の質問文を同時にアップロードできることを示します。各質問文には role と content が含まれており、role は質問者の役割を表します。提供している役割は user、assistant、system の3種類です。もう一方の content は、質問する具体的な内容です。 同時に、右側には対応する呼び出しコードが生成されていることに気付くことができます。コードをコピーして直接実行することも、「Try」ボタンを直接クリックしてテストすることもできます。 よく使用されるオプションパラメータ:
  • max_tokens:1回の応答における最大 token 数を制限します。
  • temperature:生成のランダム性で、0-2 の範囲です。値が大きいほど発散します。
  • n:一度に生成する候補応答の数です。
  • response_format:返却形式の設定です。

呼び出し後、返却結果は次のとおりです。
返却結果には複数のフィールドがあり、以下のとおりです。
  • id、今回の対話タスクの ID を生成し、今回の対話タスクを一意に識別するために使用されます。
  • model 、選択した OpenAI ChatGPT 公式サイトのモデルです。
  • choices、ChatGPT が質問文に対して提供する回答情報です。
  • usage :今回の質疑応答における token の統計情報です。
このうち choices には ChatGPT の回答情報が含まれており、その中の choices は ChatGPT です。図のように確認できます。

確認できるように、choices 内の content フィールドには ChatGPT が返信した具体的な内容が含まれています。

ストリーミングレスポンス

このインターフェースはストリーミングレスポンスにも対応しており、Web ページとの連携に非常に役立ち、Web ページ上で1文字ずつ表示する効果を実現できます。 レスポンスをストリーミングで返却したい場合は、リクエストヘッダー内の stream パラメータを true に変更できます。 図のように変更しますが、呼び出しコードもストリーミングレスポンスをサポートするために対応する変更が必要です。

stream を true に変更すると、API は対応する JSON データを行ごとに返却します。コードレベルでは、行ごとの結果を取得するために対応する変更を行う必要があります。 Python サンプル呼び出しコード:
出力結果は以下のとおりです。
レスポンス内には多数の data があり、data 内の choices が最新の回答内容であり、上記で紹介した内容と一致していることがわかります。choices は追加された回答内容であり、結果に基づいてご自身のシステムに連携できます。また、ストリーミングレスポンスの終了は data の内容によって判断され、内容が [DONE] の場合、ストリーミングレスポンスの回答がすべて終了したことを示します。返される data の結果には複数のフィールドがあり、以下のとおりです:
  • id、この対話タスクを生成する ID。この対話タスクを一意に識別するために使用します。
  • model 、選択した OpenAI ChatGPT 公式サイトのモデル。
  • choices、ChatGPT が質問語に対して提供する回答情報。
JavaScript もサポートされています。たとえば、Node.js のストリーミング呼び出しコードは以下のとおりです:
Java サンプルコード:
その他の言語については別途ご自身で書き換えることができ、原理はすべて同じです。

複数ターンの対話

複数ターンの対話機能を連携したい場合は、messages フィールドに複数の質問語をアップロードする必要があります。複数の質問語の具体例は以下の図のとおりです:

Python サンプル呼び出しコード:
複数の質問文をアップロードすることで、簡単に複数ターンの会話を実現でき、以下のような回答を取得できます:
ご覧のとおり、choices に含まれる情報は基本的な使用方法の内容と一致しており、これは ChatGPT が複数の会話に対して返信する具体的な内容を含んでいます。これにより、複数の会話内容に基づいて対応する質問に回答できます。

OpenAI-Python との連携

OpenAI Chat Completion API は公式 OpenAI インターフェースとの互換性を維持しており、公式 SDK OpenAI-Python を直接使用して連携できます。本稿では使用方法を簡単に紹介します。
  1. まずローカルの Python 環境を構築する必要があります。この手順は Google で検索できます。
  2. 開発環境をダウンロードしてインストールします。たとえば VSCode エディタをインストールします。
  3. OpenAI 環境変数を設定します。
  • プロジェクトフォルダ内に .env という名前のファイルを作成して保存します
  • .env ファイルの内容:
sk-xxx は自分の key に置き換えてください。OPENAI_BASE_URL は OpenAI のプロキシインターフェースにアクセスするためのものです。
  1. プロジェクトが依存するパッケージをインストールします
Mac OS でのコマンドは次のとおりです:
  1. サンプルソースコードファイルを作成します
例として、index.py というサンプルコードを作成したと仮定します。具体的な内容は以下のとおりです:

インターネット接続モデル

gpt-3.5-browsing および gpt-4-browsing モデルは他のモデルとは異なり、質問文に基づいてインターネット検索を行い、インターネット検索の結果を適切に調整して返すことができます。本稿では、具体的な例を通じてインターネット接続機能を説明します。続いて、OpenAI Chat Completion API 画面で対応する内容を入力できます。図のとおりです:

同時に、右側には対応する呼び出しコードの生成があることに気付くでしょう。コードをコピーして直接実行することも、「Try」ボタンを直接クリックしてテストすることもできます。

呼び出し後、返された結果は以下のとおりです:
ご覧のとおり、choices 内の回答情報はインターネット検索によって取得されたものであり、関連リンクも提示されています。choices 内の回答情報は markdown 構文でレンダリングする必要があり、そうすることで最適な体験を得られます。最後に、これは当社モデルのインターネット接続機能が持つ強力な利点も示しています。

ビジョンモデル

gpt-4o は OpenAI が開発したマルチモーダル大規模言語モデルであり、GPT-4 をベースに視覚理解能力を追加しています。このモデルはテキストと画像の入力を同時に処理でき、クロスモーダルな理解と生成を実現しています。 gpt-4o モデルのテキスト処理の使用方法は、上記の基本的な使用方法の内容と一致しています。以下では、モデルの画像処理能力を使用する方法について簡単に紹介します。 gpt-4o モデルの画像処理能力は、主に元の content 内容に type フィールドを追加することで使用します。このフィールドにより、アップロードされたものがテキストか画像かを判別し、gpt-4o モデルの画像処理能力を使用できます。以下では主に、Curl と Python の2つの方法でこの機能を呼び出す方法を説明します。
  • Curl スクリプト方式
  • Python スクリプト方式
その後、以下の結果を取得できます。結果内のフィールド情報は上記と一致しており、具体的には以下の通りです:
回答内容が画像に基づいたものであることがわかるため、上記の2つの方法によって gpt-4-vision モデルのテキストおよび画像処理能力を簡単に利用できます。 また、gpt-4o のほかに、より低コストのモデルである gpt-4o-mini もあります。gpt-4o-mini は OpenAI が開発した最新世代の大規模言語モデルであり、応答速度が速いだけでなく、価格もより安く、マルチモーダルもサポートしています。vision 機能の使用については、上記の gpt-4o モデルの使用内容を参照できます。

GPT-4o 画像生成モデル

参照画像に基づく画像生成

以下は、1枚の画像に基づいてカスタムスタイルの画像を生成する例です。まず、入力する画像を見てみましょう。以下の図の通りです: 参照画像は実在人物の画像であることがわかります。これを別のスタイルに変化させることができます。たとえば、アニメ風の画像にする場合、具体的なリクエスト例は次の通りです:
サンプル結果:
このうち、choices 内の message.content が生成された完全な対話結果であり、画像は Markdown 形式でその中に含まれています(画像リンクは一時的なアドレスであるため、速やかにダウンロードして保存してください)。生成された画像が実際にアニメ風であることがわかります。具体的には以下の図の通りです:

テキストのみでの画像生成

プロンプトを通じて画像を生成し、対話形式の結果として返してもらうことができます。以下では、未来都市の夕日の画像を作成するを例として、具体的な例を示します:
サンプル結果:
結果がプロンプトに合致していることがわかります。具体的には以下の通りです:

複数画像から1枚の画像を生成

複数の参照画像を使用して1枚の画像を生成することもできます。たとえば、イケメンの画像とコーヒーの画像を使用し、この2枚の画像を利用してイケメンがコーヒーを飲む画像を生成できます。以下が具体的な参照画像です:

以下では、男性がコーヒーを持ち上げ、今にも飲もうとしている様子を生成するを例として、具体的な例を示します:
サンプル結果:
ご覧のとおり、生成された結果は確かに2枚の画像を組み合わせて生成されたものです。以下が具体的な結果です:

エラー処理

API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例えば:
  • 400 token_mismatched:Bad request、パラメータが不足しているか無効である可能性があります。
  • 400 api_not_implemented:Bad request、パラメータが不足しているか無効である可能性があります。
  • 401 invalid_token:Unauthorized、認証トークンが無効または不足しています。
  • 429 too_many_requests:Too many requests、レート制限を超過しています。
  • 500 api_error:Internal server error、サーバーで問題が発生しました。

エラー応答の例

結論

本ドキュメントを通じて、OpenAI Chat Completion API を使用して公式 OpenAI ChatGPT の対話機能を簡単に実現する方法をご理解いただけたと思います。本ドキュメントが、この API の連携と利用により役立つことを願っています。ご不明な点がございましたら、いつでも当社の技術サポートチームまでお問い合わせください。