Ciyo · GPT-6
創作アプリのためのGPT-6 Astra APIガイド
GPT-6 Astraの公式APIモデルIDはgpt-6-astraです。OpenAIのモデルガイドはResponses APIで構築するよう案内し、モデルページにはResponses、Chat Completions、Batchの対応が記載されています。指示を画像、レイアウト、文章に変える製品では、推論の制御、組み込みの画像ツール、価格帯が重要な部分です。
本ガイドは2026年9月7日のOpenAI開発者向け資料を反映しています。創作ツールを作る人向けに書いているため、一般的なエージェントの設計よりも、画像生成ツールと素材当たりの費用に多くの分量を割きます。公開前にリンク先を再確認してください。パラメーターと価格は日付付きのスナップショットです。
コードを書く前にアクセスを確認する
APIアクセスはChatGPTの契約とは別です。PlusやProプランはAPIクレジットを作らず、APIキーはChatのGPT-6 Proを解放しません。リクエストの費用を支払う組織とプロジェクトでgpt-6-astraが表示されることを確認し、ファイル、ツール、大きなコンテキストを追加する前に、小さなテキストリクエストを一つ通します。
レート制限は使用量ティアに応じて増えます。モデルページはTier 1で毎分500リクエストと500,000トークン、Tier 5で毎分15,000リクエストと40,000,000トークンを記載しています。カタログ全体のバリエーションを生成するバッチ処理は、この数値に合わせて規模を決めるか、待ち時間が問題にならないBatchエンドポイントへ移します。
最初のリクエスト
Responses APIのリクエストでmodelにgpt-6-astraを設定し、プロンプトをinputとして渡します。このモデルではChat Completionsがツール呼び出しに対応していないため、ガイドはResponses APIを推奨しています。推論はResponsesではreasoning.effortで、Chat Completionsに留まる必要があればreasoning_effortで設定します。
Astraはlow、medium、high、xhigh、maxの推論量に対応します。noneとminimalには対応していないため、それらを使ったGPT-5.6のリクエストからコピーした設定は、lowから始めて比較します。temperature、top_p、top_logprobs、logprobsは削除します。モデルガイドは、Astraへ移行する際に外すパラメーターとしてこれらを挙げています。
| フィールド | 値 | 理由 |
|---|---|---|
| model | gpt-6-astra | 公開されている唯一のスナップショット |
| input | テキストの指示、必要なら画像も | テキストと画像の入力に対応 |
| reasoning.effort | low、medium、high、xhigh、max | noneとminimalは非対応 |
| tools | 必要なときに [{ type: "image_generation" }] | ターンに描画モデルを追加 |
| temperature、top_p、logprobs | 省略 | 削除対象のパラメーター |
制作タスクごとに推論量を選ぶ
OpenAIの推論ガイドは、lowを下書きや実行中心の作業、mediumを調査やスプレッドシート・スライドの作業、highを難しい推論と深い計画、xhighやmaxを待ち時間より品質が重要な長い実行に対応づけています。創作アプリにはそのまま当てはまります。代替テキストやキャプションのバリエーションはlow、キャンペーンの指示はmedium、制約が衝突する複数素材の計画はhighです。
推論量は費用の制御でもあります。推論トークンはレスポンスには表示されませんが、出力トークンとして100万当たり50ドルで課金され、コンテキストウィンドウの領域を占めます。usageオブジェクトはoutput_tokens_details.reasoning_tokensにその値を報告します。リクエストごとにこのフィールドを記録してください。見える回答が似ている二つのリクエストの費用が大きく違う理由が分かります。
画像生成ツールを呼び出す
リクエストにtools: [{ type: "image_generation" }]を追加し、inputで画像を説明します。Astraが画像を計画してツールを呼び出し、レスポンスにはimage_generation_call型の出力項目が含まれ、そのresultフィールドにbase64形式の画像が入ります。ツールはsize、quality（low、medium、high）、format、compression、background、auto・generate・editのaction、ストリーミングプレビュー用の1から3のpartial_imagesを受け付けます。
画素はAstraではなくGPT Image 2が描画し、画像モデルの単価で課金されます。標準価格では画像出力トークン100万当たり30ドル、画像入力トークン100万当たり8ドル、テキスト入力トークン100万当たり5ドルです。続けて編集する場合は、previous_response_idを渡すか、以前のimage_generation_callをinputに含めて、描画モデルが元画像を参照として保持できるようにします。
非同期ツールと作業中の指示変更
Astraは非同期の関数呼び出しを導入しました。関数にasync: trueを付けると、あなたのコードがツールを実行する間もモデルは作業を続け、準備ができたら元のcall_idで結果を返します。創作アプリでは、動画プレビューの描画や大きな素材ライブラリの取得のような遅い工程に向いています。
作業中の指示変更では、タスクの実行中にWebSocketで更新を送れます。Responses APIは完了済みの作業を保持し、訂正を反映します。configuration_update入力項目は、プロンプトを書き換えずに会話中の推論量を変更するため、キャッシュ済みの接頭部分が維持されます。どちらもAstraで新しく公開された機能で、アプリ側での実装が必要です。
四つの価格帯を知る
標準処理は入力100万トークン当たり10ドル、キャッシュ入力1ドル、キャッシュ書き込み12.50ドル、出力50ドルです。入力が272,000トークンを超えるリクエストは長いコンテキストの価格帯で課金され、入力20ドル、キャッシュ2ドル、キャッシュ書き込み25ドル、出力75ドルになります。OpenAIが最大2倍の速度と説明するFastモードは、標準単価を2倍にして入力20ドル、出力100ドルです。
Batchエンドポイントは、短いコンテキストのリクエストで標準価格を半額にし、入力5ドル、キャッシュ0.50ドル、キャッシュ書き込み6.25ドル、出力25ドルです。文章のバリエーションの夜間生成、画像ライブラリの代替テキスト、翌日のレビュー用の指示は、Batchに向いています。FastモードはEUのデータレジデンシーでは利用できず、ガイドはStandardを使うよう案内しています。
| 価格帯 | 入力 | キャッシュ入力 | 出力 |
|---|---|---|---|
| 標準、入力272K以下 | $10 | $1 | $50 |
| 長いコンテキスト、入力272K超 | $20 | $2 | $75 |
| Fastモード | $20 | $2 | $100 |
| Batch | $5 | $0.50 | $25 |
繰り返す部分をキャッシュする
多くの制作リクエストは、トーン、禁止表現、色のルール、商品情報といったブランド部分を再利用します。このブロックを入力の先頭に置き、リクエスト間でキャッシュ済みの接頭部分が一致するようにします。Astraは以前のprompt_cache_retentionパラメーターをprompt_cache_options.ttlに置き換え、ガイドは30分のキャッシュ期間に30mという値を使っています。
キャッシュ済みトークンは10ドルではなく1ドルなので、15,000トークンのブランド部分は再利用ごとに0.15ドルではなく0.015ドルです。キャッシュ書き込みは100万当たり12.50ドルで課金されるため、このブロックは毎回変わるプロンプトではなく、安定したテキストにします。自前の分析ではキャッシュ済みトークンを別に記録してください。一貫性を高める最も安い方法です。
承認済み素材当たりの費用
非キャッシュ入力20,000トークン、出力4,000トークンの指示のリクエストは、標準単価で0.40ドルです。推論トークンを10,000追加すると、出力の行が0.50ドル増えます。高品質の画像を一枚追加すると、描画モデル自身のトークンがさらに課金されます。呼び出し当たりではなく承認済み素材当たりの費用が、その制作の流れが成り立つかを教えてくれます。
素材ごとに四つの行を追跡します。Astraの入力、推論を含むAstraの出力、画像トークン、承認までの試行回数です。三回の試行が必要な安い推論量は、一回で済む高い推論量より費用がかさむことがあります。これはCiyoが自身のクレジットに適用しているのと同じ計算方法で、各生成は実行前に価格を表示します。
APIが提供しないもの
Astraからの直接の画像出力はありません。すべての画像は画像ツールか別の描画モデルを経由します。noneの推論量、temperatureの制御、非対応パラメーターを送ったときの自動的な代替処理もありません。ChatGPTの選択肢であるGPT-6 Proは別のAPIモデルではなく、APIには一つのgpt-6-astraスナップショットがあるだけです。
安全性チェックがタスクを止めることもあります。OpenAIの公開記事は、APIでは一時停止したタスクがレビューを求めずに停止すると述べているため、本番アプリは中断されたレスポンスを適切に処理する必要があります。失敗の経路をユーザーに見えるようにし、それを生んだリクエストの記録を残してください。
あわせて読む
Astra APIに関する疑問
ChatGPT PlusプランにAstraのAPIアクセスは含まれますか？
いいえ。ChatGPTのプランとAPIの請求は別です。PlusにはChatGPT WorkとCodexでAstraが順次含まれます。gpt-6-astraのAPI利用は、組織にトークン単位で課金されます。
Responsesの代わりにChat Completionsを使えますか？
モデルページにはChat Completionsの対応がありますが、OpenAIのガイドはAstraではChat Completionsがツール呼び出しに対応しないと述べ、Responses APIを推奨しています。画像生成ツールと非同期関数はResponsesの機能です。
推論トークンは無料ですか？
いいえ。推論トークンは利用中の価格帯の出力単価で出力トークンとして課金され、コンテキストを占めます。usageオブジェクトはoutput_tokens_details.reasoning_tokensにその値を報告します。
APIキーなしで描画工程を試作する
CiyoのキャンバスでGPT Image 2で生成し、承認した出力を残し、自分の製品にAstra APIを組み込むときに同じ指示を使えます。