GPT-6.1 Terraの使い方：API設定、推論努力とツール呼び出し

GPT-6.1 Terraへの最短経路はResponses APIです。しかし、有用な実装にはモデルIDだけでは不十分です。タスクを定義し、推論レベルを選択し、適切な詳細設定で画像を提供し、出力を検証し、外部状態を変更する可能性のあるツールを制限する必要があります。

このチュートリアルでは、現在のOpenAI API規約とモデルID gpt-6.1-terra を使用します。これはTerraの公式な位置付けに合致するため、視覚的レビューのワークフローに焦点を当てています。

始める前に

GPT-6.1 TerraにアクセスできるOpenAI APIプロジェクト、ソースコードの外部に保存されたAPIキー、そして最新のOpenAI SDKが必要です。現在、モデルページでは無料プランがAPIをサポートしていないと表示されているため、ChatGPTプランのアクセス権がAPIアクセス権と同じであると想定せず、直接プロジェクト内でアクセス権を確認してください。

Python SDKをインストール：

pip install --upgrade openai

シェルまたはキーマネージャーで `OPENAI_API_KEY` を設定してください。本番用キーをスクリプト、スクリーンショット、リポジトリ、またはクライアントアプリケーションに貼り付けないでください。

## 基本テキストリクエストを開始する

```python
from openai import OpenAI

client = OpenAI()

= client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "中程度"},
    instructions=(
        簡潔な生産説明を書く。目に見える証拠を区別する
        "推論に基づき、提供された資料が不足している場合はその旨を説明する。"
    ),
    input="このコメントノートを、明確な5項目のアクションリストに変換してください：..."
)

.output_textを出力する

OpenAIは、直接のモデルリクエストと推論モデルにはResponses APIの使用を推奨しています。instructions の値は現在のリクエストに適用されます。安定した動作のガイダンスはそこに置き、ユーザー入力を具体的なタスクに集中させてください。

画像を分析する

Terraは画像入力を受け取り、テキストを返します。Responsesリクエストにはテキストと画像URLを含めることができます：

# このスクリプトは、ビデオからオーディオを抽出する方法を示すためのものです

from openai import OpenAI

client = OpenAI()

= client.responses.create( model="gpt-6.1-terra", reasoning={"effort": "中程度"}, input=[{ "role": "user", "content": [ { "type": "input_text", "text": ( この広告キャンペーンの画像を確認してください。表示されている問題のみを報告してください。 「クロッピング、テキスト配置、コントラスト、ロゴの安全性を含む。」 "各問題に対して、可視領域を指摘し、修正案を提示する。" ), }, { "type": "input_image", "image_url": "https://example.com/asset.jpg", "detail": "高い", }, ], }], )

.output_textを出力する

対応している画像形式はPNG、JPEG、WEBP、および非アニメーションGIFです。OpenAIのビジュアルガイドではBase64データURLもサポートされています。画像はトークンを消費するため、タスクに適した解像度と詳細レベルを使用してください。密度が高く座標に敏感な画面では、サポートされている場合、`original`が適切な場合があります。初期の大まかな確認には`low`で十分かもしれません。標準設定を行う前に、現在のモデル固有のサイズ表を確認してください。

## 意識的に推論の努力度を選択する

Terra は `none`、`low`、`medium`、`high`、`xhigh`、`max` をサポートしており、デフォルト値は `medium` です。処理の強度を上げると、困難なタスクの品質が向上しますが、遅延とトークン使用量も増加します。

合理的な評価の段階は次のとおりです。

- `none`：単純な抽出や分類であり、多段階の推論による価値はあまりない。
- `low`：通常の審査、起草、または制限付きツールの使用。
- `medium`：証拠、判断、または複数ステップの作業を混合する。これがデフォルト値です。
- `high`: 困難な視覚的差異、計画、または複雑な例外処理。
- `xhigh` と `max`：評価で高価値タスクに実質的な利益があると示された場合のみ使用します。

答えが失敗した場合、自動的に努力の度合いを上げないでください。まず、プロンプト、証拠、画像品質、出力契約、検証ロジックを確認してください。

## 構造化出力のリクエスト

生産システムは、既知のパターンが利用可能な場合に任意のテキストを解析すべきではありません。Terraは構造化出力をサポートしています。視覚品質チェックパターンには、カテゴリ、証拠、重大度、推奨事項を含む問題の配列が必要になる場合があります。

正確なSDK補助構文は変わる可能性があるため、現在お使いの言語向けの「構造化出力」ガイドに従ってください。構文に関係なく、返されたオブジェクトを検証し、必要な証拠が不足している場合にアプリケーションが実行すべきアクションを定義してください。有効なJSON構造でも、不正確な観察結果が含まれる可能性があります。

## レスポンスAPIによるツールの追加

TerraがリストアップするResponses APIツールには、ウェブ検索、ファイル検索、画像生成、コードインタプリタ、ホスティングシェル、コンピュータ利用、MCPなどが含まれます。タスクに必要なツールのみを公開します。

コンピュータ利用に関して、お客様のアプリケーションは実行環境を実行または接続し、許可された操作を実行し、スクリーンショットを返し、必要に応じてセッションを維持する必要があります。OpenAIの安全ガイドラインでは以下を推奨しています：

- 隔離されたブラウザまたは仮想マシン。
- ウェブサイトと操作の許可リスト。
- ページテキストやスクリーンショットに認証情報が表示されないようにしてください。
- 購入、データ転送、削除、その他の重要な操作の前に、ユーザーの承認を得る必要があります。
- 手順、時間、およびコストの制限。
- 保存された結果を検証し、モデルの要約を信頼しないこと。

ページの内容は信頼できません。ウェブページは新しい権限を付与したり、ユーザーの指示を上書きしたりすることはできません。

## 信頼性の高いビジュアルレビューループ

安定した実装は観察と行動を分離する：

1. 画像と狭い審査基準を送信します。
2. 各発見には目に見える証拠が必要である。
3. 応答モードを検証します。
4. 高重大性または低エビデンスの発見を関係者に転送する。
5. 変更が許可されている場合は、必要な編集ツールまたはコンピュータツールのみを公開します。
6. キャプチャ結果の状態を確認し、検証プロセスを実行します。
7. 元の内容、提案された操作、承認、出力、および審査者の決定を保存します。

クリエイティブワークにおいて、Terraは絵コンテのレビューを構造化された修正ブリーフに変換できます。クリエイターはその後、独立した画像、アニメーション、またはストーリー制作ツールで、承認されたブリーフを適用できます。

## よくある実装の誤り

### 動画ファイルを直接送信

Terra はネイティブのビデオ入力をリストしていません。代表的なフレームを抽出し、必要に応じて文字起こしやショットのメタデータを提供します。分析がこれらの素材に基づいていることを明確に説明します。

### 自由形式のツール使用を許可する

モデルに広範なコンピュータへのアクセス権限を付与すると、不必要なリスクが生じます。ツール、ドメイン、操作、データを制限してください。影響が生じるノードでは承認を要求してください。

### 出力を事実の根拠として扱う

視覚モデルは微小な詳細を見落としたり、裏付けのない関係性を推測したりする可能性があります。エラーの影響が重大な場合は、既知のテストケースと人間によるレビューを使用してください。

### 長いコンテキストの価格設定を無視する

Terraのコンテキストウィンドウは105万トークンですが、272,000入力トークンを超えるプロンプトはより高い料金で請求されます。関連する資料のみを取得するようにしてください。

## よくある質問

### GPT-6.1 Terra のチャット補完機能は使用できますか？

モデルページではChat Completionsがエンドポイントとして列挙されていますが、ツール呼び出しにはResponses APIが必要であると指摘されています。新しいツール使用の実装では、Responsesが適切なデフォルトの選択肢です。

### Terraは微調整をサポートしていますか？

現在のモデルページでは、微調整はサポートされていないと記載されています。微調整を中心とした計画を立てるのではなく、明確な指示、検索、例、パターン、評価を使用してください。

### より高い推論能力へのアップグレードをテストするにはどうすればよいですか？

2つ以上の努力レベルで同じ代表的な評価セットを実行します。受け入れられた結果、レイテンシ、トークン使用状況、失敗カテゴリを比較します。印象的な例だけに基づいて判断しないでください。

## 実施概要

Responses API を介して `gpt-6.1-terra` を使用し、中程度の努力から始めて、モデルに必要な証拠とツールのみを提供し、構造と内容を検証します。周囲のフレームワークの品質——権限、評価、検証、ログ記録——は、モデルの選択と同様に重要です。