Skip to main content
OpenAI は最近、モデル応答を作成するためのインターフェースを提供しました。テキストまたは画像入力を提供して、テキストまたは画像出力を生成します。モデルに独自のカスタムコードを呼び出させたり、web 検索やファイル検索などの組み込みツールを使用させたりして、独自のデータをモデル応答の入力として使用できます。 本ドキュメントでは主に OpenAI Responses API 操作の使用フローを紹介し、これを利用することで、公式 OpenAI のモデル応答作成機能を簡単に使用できます。

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

基本的な使用方法

続いて、画面上で対応する内容を入力できます。図のとおりです。

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

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

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

ストリーミング応答

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

stream を true に変更すると、API は対応する JSON データを1行ずつ返します。コードレベルでは、1行ずつの結果を取得するために対応する変更を行う必要があります。 Python サンプル呼び出しコード:
出力結果は以下のとおりです:
レスポンス内には多数の data があることが確認でき、data 内の delta が最新の回答内容であり、上記で紹介した内容と一致しています。delta は追加された回答内容であり、結果に基づいてご自身のシステムに接続できます。ストリーミングレスポンスは response.completed または response.incomplete を終端状態とします。終端状態内の usage は今回のリクエストの最終 token 使用量であり、課金の基準でもあります。 クライアントが終端状態に到達する前に接続を切断した場合、今回のリクエストはクライアントが閉じられた(499)として記録され、ローカルで推定した token を使用して課金されることはありません。接続が正常に終了したものの終端状態および最終 usage を受信していない場合、今回のリクエストはレスポンス不完全(502)として記録され、同様に推定 token を使用して課金されることはありません。この2つの状況に遭遇した場合は、リクエストを再度開始してください。 返される data の結果には複数のフィールドがあり、以下のとおりです。
  • item_id、今回の会話タスクを生成する ID であり、今回の会話タスクを一意に識別するために使用されます。
  • type、今回の会話 Responses タスクを生成するタイプです。
  • model 、選択した OpenAI ChatGPT 公式サイトのモデルです。
  • delta、質問語に対して ChatGPT が提供する回答情報です。
JavaScript も対応しており、たとえば Node.js のストリーミング呼び出しコードは以下のとおりです。
Java サンプルコード:
その他の言語については、別途ご自身で書き換えることができ、原理はすべて同じです。

マルチターン会話

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

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

ビジョンモデル

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

ファイル処理モデルの作成

リクエスト例:
結果例:
ご覧のとおり、入力ファイルについてもファイル処理を行っており、結果は上記と類似しています。

エラー処理

API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例:
  • 400 token_mismatched:不正なリクエスト。パラメータの欠落または無効が原因である可能性があります。
  • 400 api_not_implemented:不正なリクエスト。パラメータの欠落または無効が原因である可能性があります。
  • 401 invalid_token:認証されていません。認可トークンが無効または欠落しています。
  • 429 too_many_requests:リクエストが多すぎます。レート制限を超過しています。
  • 500 api_error:内部サーバーエラー。サーバー側で問題が発生しました。

エラー応答の例

結論

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