> ## Documentation Index
> Fetch the complete documentation index at: https://docs.widerouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# プレイグラウンド

> このページから実際の生成タスクを送信し、返されたタスク ID を使ってポーリングします。

APIキーとプロンプトを入力して送信してください。実際の API にリクエストが送信されます。これは、コードから呼び出すエンドポイントと同じです。

<Warning>
  **このページから送信されたリクエストは実際のものであり、APIキーに課金されます。**
  1K画像1枚あたりの料金は、モデルによって約 \$0.02～0.09です。ここでの操作は
  サンドボックスでもモックでもありません。
</Warning>

## パラメータ

<ParamField body="model" type="string" required>
  実行するモデルです。`gemini-3-pro-image` または `gemini-3.1-flash-image` を受け付けます。
  完全一致が必要です — エイリアスや `-preview` サフィックスは使用できません。
</ParamField>

<ParamField body="input" type="object" required>
  生成パラメータです。以下に記載されていないキーは
  `invalid_params` により拒否されます。

  <Expandable title="input">
    <ParamField body="input.prompt" type="string" required>
      生成する内容です。1～32000バイトです。
    </ParamField>

    <ParamField body="input.n" type="integer" default="1">
      生成する画像の枚数です。1～4枚です。それぞれが
      `outputs` 内の個別のエントリになります。
    </ParamField>

    <ParamField body="input.aspect_ratio" type="string">
      `1:1` `2:3` `3:2` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` のいずれかです。
      省略すると正方形の画像になります。参照画像を渡した場合は、
      元画像に従います。
    </ParamField>

    <ParamField body="input.image_size" type="string" default="1K">
      `1K`、`2K`、または `4K` です。大文字と小文字を区別します。フレーム全体が拡大されるため、
      `21:9` 画像を `4K` で指定すると、6336 × 2688 で返されます。
    </ParamField>

    <ParamField body="input.images" type="string[]">
      編集または合成に使用する参照画像です。最大14枚まで指定できます。各エントリは
      `https` URL または base64 データ URI です。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="callback_url" type="string">
  完了したタスクを POST する `https` URL です。これによりポーリングを省略できます。
  `https` である必要があり、それ以外は送信時に拒否されます。
</ParamField>

## 返ってくる内容

送信すると、1秒未満ですぐにレスポンスが返ります。画像はこのレスポンスには**含まれません**。生成はバックグラウンドで行われます。

| フィールド        | 型       | 備考                           |
| ------------ | ------- | ---------------------------- |
| `id`         | string  | タスク ID です。その他すべての処理で必要になります。 |
| `status`     | string  | 新しいタスクでは `queued` です。        |
| `created_at` | integer | Unix 秒、UTC。                  |

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "task_dksUgWLYX4jIVueCACD8KwJzjR5JhRsI",
    "status": "queued",
    "created_at": 1788104112
  }
  ```
</ResponseExample>

## その後、画像のポーリングを行います

このプレイグラウンドでは作成呼び出しのみを扱います。上記のレスポンスから `id` を取得し、
`status` が `completed` または `failed` に到達するまでタスクを読み取ります。1K画像の場合、
15～40秒かかると見込んでください。

```bash theme={null}
curl https://api.widerouter.com/v1/task/$TASK_ID \
  -H "Authorization: Bearer $WIDEROUTER_API_KEY"
```

完了したタスクには、画像URLの `outputs` 配列が含まれます。

```json theme={null}
{
  "id": "task_dksUgWLYX4jIVueCACD8KwJzjR5JhRsI",
  "status": "completed",
  "outputs": ["https://…/task_dksUgWLYX4jIVueCACD8KwJzjR5JhRsI_0.jpg"],
  "counts": { "requested": 1, "succeeded": 1, "failed": 0 }
}
```

<Warning>
  出力URLは認証なしで使用でき、タスクの作成から24時間後に有効期限が切れます。
  ダウンロード時には `User-Agent` ヘッダーを送信してください。配信CDNは、ヘッダーなしの
  リクエストに対して単なる `403` を返します。
</Warning>

## 次のステップ

<CardGroup cols={2}>
  <Card title="概要" icon="layers" href="/ja/models/nano-banana/overview">
    シリーズのすべてのパラメータ、解像度ティア、実測レイテンシ。
  </Card>

  <Card title="非同期タスク API" icon="clock" href="/ja/api/async-tasks">
    ポーリングループ、コールバック、完全なエラーテーブル。
  </Card>
</CardGroup>