# GPT Astra 6 API (https://wanapi.app/ja/docs/gpt-6-astra)





**GPT Astra 6** を OpenAI Responses または Chat Completions 形式で、Wan API キーを使って呼び出します。[GPT モデルを比較](/ja/docs/gpt-api)。

## モデル設定 [#モデル設定]

| 設定           | GPT Astra 6                             |
| ------------ | --------------------------------------- |
| リクエストのモデル ID | `gpt-6-astra`                           |
| 入力 / 出力      | テキスト・画像 / テキスト                          |
| コンテキストウィンドウ  | 1,050,000 トークン                          |
| 最大入力         | 922,000 トークン                            |
| 最大出力         | 推論を含めて 128,000 トークン                     |
| 推論の強度        | `low`, `medium`, `high`, `xhigh`, `max` |
| 推論強度の既定値     | 明示的に指定してください                            |

これらはモデル本来の上限です。リクエストには、利用できるチャネルとアカウントの制限も適用されます。音声と動画の入力には対応していません。

## 接続とリクエストの送信 [#接続とリクエストの送信]

[API キー設定](/ja/settings/apikeys)でキーを作成し、サーバー上で `WAN_API_KEY` として保管してください。1 つのキーと同じ前払い残高を、モデルやグループをまたいで利用できます。6.1 の小数点も含め、正確なモデル ID を指定してください。

```bash
curl https://api.wanapi.app/v1/responses \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "input": "Explain the purpose of a database index in three sentences.",
    "reasoning": {"effort": "low"},
    "max_output_tokens": 1024
  }'
```

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app/v1",
)
response = client.responses.create(
    model="gpt-6-astra",
    input="Explain the purpose of a database index in three sentences.",
    reasoning={"effort": "low"},
    max_output_tokens=1024,
)
print(response.output_text)
```

## Responses のパラメータ [#responses-のパラメータ]

| フィールド                                                                | 必須  | 仕様                                                  |
| -------------------------------------------------------------------- | --- | --------------------------------------------------- |
| `model`                                                              | はい  | `gpt-6-astra`.                                      |
| `input`                                                              | はい  | プロンプト文字列、または入力項目の配列。                                |
| `instructions`                                                       | いいえ | システムまたは開発者の指示。                                      |
| `max_output_tokens`                                                  | いいえ | 推論を含む出力トークン数の上限。最大 128,000 トークン。                    |
| `reasoning.effort`                                                   | いいえ | low, medium, high, xhigh, max.                      |
| `reasoning.summary`                                                  | いいえ | `auto`、`concise`、`detailed`。                        |
| `text.verbosity`                                                     | いいえ | `low`、`medium`、`high`。                              |
| `text.format`                                                        | いいえ | テキスト、または対応する JSON Schema などによる構造化出力。                |
| `stream`                                                             | いいえ | `true` なら Server-Sent Events、それ以外は完全なレスポンスを返します。    |
| `tools`, `tool_choice`                                               | いいえ | ツールの宣言と選択。クライアント関数はアプリケーション側で実行します。                 |
| `parallel_tool_calls`, `max_tool_calls`                              | いいえ | 対応する場合、ツールの並列実行と呼び出し回数を制限します。                       |
| `include`                                                            | いいえ | `reasoning.encrypted_content` など、レスポンスに追加するフィールド。   |
| `metadata`, `store`                                                  | いいえ | メタデータとレスポンスの保存設定。                                   |
| `previous_response_id`                                               | いいえ | 過去のレスポンス ID。処理を担当する上流サービスで参照できる間のみ利用できます。           |
| `truncation`                                                         | いいえ | 入力の切り詰め方針。                                          |
| `prompt_cache_key`, `prompt_cache_retention`, `prompt_cache_options` | いいえ | チャネルが対応する場合のキャッシュのルーティングと保持設定。                      |
| `reasoning.mode`, `reasoning.context`                                | いいえ | 上流サービスに転送されます。モデル固有の制限があるため、ワークフローで必要な場合のみ指定してください。 |
| `context_management`, `conversation`, `prompt`                       | いいえ | 上流サービスが対応する場合の、モデル本来のコンテキストや保存済みプロンプトの設定。           |

## 推論とツール [#推論とツール]

Astra は常に推論を行い、`none` と `minimal` には対応していません。ツール呼び出しには Responses API が必要です。既定値は明記されていないため、推論強度を明示的に指定してください。

推論が有効な場合は `temperature`、`top_p`、`top_logprobs` を省略してください。Chat Completions では `logprobs` も省略し、Responses では `include` に `message.output_text.logprobs` を指定しないでください。

出力トークン数の上限には、推論と表示されるテキストの両方が含まれます。回答が完成する前に上限に達する場合があります。推論強度を上げると、出力トークン数や処理時間が増えることがあります。

構造化出力には `text.format` を使い、`type: "json_schema"`、名前、モデルが対応するスキーマを指定します。スキーマは形式を制約するもので、内容の正確さを保証するものではありません。ツールを使った会話を続けるときは、元の呼び出し ID とともにクライアント関数の結果を返してください。

## 現在の API 対応範囲 [#現在の-api-対応範囲]

ゲートウェイは `POST /v1/responses` と `POST /v1/chat/completions` を受け付けます。利用できるモデルは設定済みチャネルによって決まるため、連携前に認証付きの `GET /v1/models` で確認してください。以下の料金が表示されていない場合、モデルを呼び出せる状態とは判断できません。

互換レイヤーは認識したフィールドを転送し、任意の JSON をそのまま転送するわけではありません。現在の Responses DTO には、ネイティブの `access_programs`、`image`、`background` フィールドが含まれていません。無視されたフィールドが反映されたとは考えないでください。`service_tier` と `safety_identifier` もチャネル設定によって除去される場合があります。

この連携では Files API、Batch API、バックグラウンド応答をポーリングする仕組みは提供していません。同期レスポンスまたは SSE を使用してください。組み込みツールは上流サービスでの提供状況に依存し、別途料金が発生する場合があります。ツールを宣言できても、そのセッション全体をここで利用できるとは限りません。

## 画像入力 [#画像入力]

ご自身でホストする、公開アクセス可能な HTTP(S) 画像 URL を使用してください。画像と質問をユーザーの入力項目に入れます。

```json
{"role":"user","content":[
  {"type":"input_image","image_url":"https://example.com/chart.png"},
  {"type":"input_text","text":"What does this chart show?"}
]}
```

サンプルの URL をご自身の画像 URL に置き換えてください。この連携ではアップロードやメディア保存サービスを提供していません。

## Chat Completions [#chat-completions]

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [{"role":"user","content":"Explain what a database index does."}],
    "reasoning_effort": "low",
    "max_completion_tokens": 1024
  }'
```

`choices[0].message.content` からテキストを取得します。Chat Completions は `messages`、`reasoning_effort`、`max_completion_tokens` を使い、Responses は `input`、`reasoning.effort`、`max_output_tokens` を使います。Chat Completions の画像メッセージには `type: "image_url"` と `image_url: {"url":"https://..."}` を指定してください。

## 料金 [#料金]

100 万トークンあたりの米ドル料金

現在の単価には各グループの倍率が反映されています。料金情報は最大 2 分間キャッシュされます。

1 つの API キーですべてのモデルとグループを利用できます。「デフォルト」は自動ルーティング順で最初に利用できるグループを示します。実際に選ばれたグループの単価で課金されます。

### GPT Astra 6

`gpt-6-astra`

| 課金対象トークン | gpt · デフォルト · 入力トークン数 ≤ 272,000 | gpt · デフォルト · 入力トークン数 > 272,000 | gpt-0.7 · 入力トークン数 ≤ 272,000 | gpt-0.7 · 入力トークン数 > 272,000 |
| --- | ---: | ---: | ---: | ---: |
| 入力（未キャッシュ） | $1 | $2 | $7 | $14 |
| 出力 | $5 | $7.5 | $35 | $52.5 |
| キャッシュ読み取り | $0.1 | $0.2 | $0.7 | $1.4 |
| キャッシュ書き込み | $1.25 | $2.5 | $8.75 | $17.5 |

しきい値の基準：キャッシュを含む入力トークンの総数。選ばれた料金区分は、しきい値を超えた分だけでなく、リクエスト全体に適用されます。

— は確認済みの単価がないことを示します。無料という意味ではありません。

キャッシュ単価は、レスポンスに対応するキャッシュ使用量が報告された場合のみ適用されます。キャッシュされたトークンを未キャッシュ入力として二重に数えないでください。

課金対象の各トークン数に対応する単価を掛け、1,000,000 で割って料金を計算します。推論は出力トークンに含まれ、別途二重に課金されません。キャッシュされた入力を未キャッシュ入力として重複計上しないでください。レスポンスが報告したキャッシュ使用量だけを使用します。表にキャッシュ書き込みの単価があっても、すべての保持モードに対応するとは限りません。

入力長に応じた料金では、該当する料金区分がリクエスト全体に適用されます。固定単価を前提にせず、表のしきい値とその基準となる入力を確認してください。グループヘッダーを省略したリクエストは `gpt` を使用します。Responses または Chat Completions でグループを選ぶには、`X-Model-Group: gpt` または `X-Model-Group: gpt-0.7` を指定してください。 `gpt-0.7` を利用できるのは Luna、Sol、Astra のみです。Terra は `gpt` のみに対応します。明示的に選択した場合、別のグループには切り替わりません。モデル ID は変更しないでください。グループのサフィックスは使用できません。

## レスポンスとストリーミング [#レスポンスとストリーミング]

完了した Responses の結果には `id`、`model`、`status`、`output`、`usage` が含まれます。`output` には推論、ツール呼び出し、メッセージが入り、先頭の項目がテキストとは限りません。OpenAI SDK の `output_text` ヘルパーでテキスト出力をまとめて取得できます。

SSE を使うには `stream: true` を指定し、`curl -N` を使用します。`response.created`、`response.output_text.delta`、`response.completed` に加え、未完了のレスポンスとエラーも処理してください。終端のレスポンスに使用量が含まれます。Chat Completions は `choices[].delta` を配信します。最後の使用量チャンクを受け取るには `stream_options: {"include_usage":true}` を指定してください。

## 使用ログとエラー [#使用ログとエラー]

[LLM ログ](/ja/usage)では、過去 7 日間の完了した呼び出しについて、モデル、入力トークン、出力トークン、料金を確認できます。`gpt-6-astra` で絞り込んでください。画像と動画は[タスクログ](/ja/tasks)で確認します。

失敗時は HTTP ステータスと `error` オブジェクトを確認してください。キー、[残高](/ja/docs/balance)、正確なモデル ID、パラメータの組み合わせを確認します。リクエストやストリームが中断された場合は、再試行の前にログを確認してください。新しいリクエストで追加の料金が発生する場合があります。

## モデルの参考資料 [#モデルの参考資料]

* [GPT Astra 6 公式仕様](https://developers.openai.com/api/docs/models/gpt-6-astra)
* [Responses リファレンス](https://developers.openai.com/api/reference/resources/responses/methods/create)
* [GPT モデルと推論](https://developers.openai.com/api/docs/guides/latest-model)
