> ## 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.

# プレイグラウンド

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

APIキーとプロンプトを入力して、送信します。これはライブAPIにリクエストを送信します。コードから呼び出すものと同じ
エンドポイントであり、動画モデルにアクセスする唯一の方法です。

<Warning>
  **このページから送信されたリクエストは実際のものであり、APIキーに課金されます。**
  動画は1秒単位で課金されます。1秒の`480p`クリップは\$0.05～\$0.08、
  15秒の`1080p`クリップは数ドルかかります。まずは短い動画から始めてください。
</Warning>

## パラメータ

<ParamField body="model" type="string" required>
  実行するモデルです。`grok-imagine-video`または`grok-imagine-video-1.5`を受け付けますが、
  完全一致である必要があります。既存のクリップを編集または拡張できるのは
  `grok-imagine-video`のみです。`1080p`およびプリセット音声にアクセスできるのは`grok-imagine-video-1.5`のみです。
</ParamField>

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

  <Expandable title="入力">
    <ParamField body="input.prompt" type="string" required>
      生成する内容、または編集時に変更する内容です。
    </ParamField>

    <ParamField body="input.mode" type="string" default="generate">
      `generate`、`edit`、または`extend`です。`edit`と`extend`はいずれも
      `input.video`を必要とし、`grok-imagine-video`でのみ機能します。
    </ParamField>

    <ParamField body="input.duration" type="integer">
      長さを秒単位で指定します（1～15秒）。`extend`モードでは上流モデルによって
      2～10秒に制限されます。この制限は送信時ではなく、タスクがキューに入れられた後に適用されます。
      `edit`では使用されず、ソースの長さに従います。
    </ParamField>

    <ParamField body="input.resolution" type="string" default="480p">
      `grok-imagine-video-1.5`でのみ、`480p`、`720p`、または`1080p`を指定できます。`edit`モードでは拒否され、
      `input.reference_images`が設定されている場合は`720p`を上限とします。
    </ParamField>

    <ParamField body="input.aspect_ratio" type="string" default="16:9">
      `1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`のいずれかです。画像モデルとは異なり、
      ここでは`auto`はありません。
    </ParamField>

    <ParamField body="input.images" type="string[]">
      クリップの**最初のフレーム**として使用する画像を1枚だけ指定します。`https` URL
      または base64 データ URI を指定します。`input.reference_images`とは併用できません。
    </ParamField>

    <ParamField body="input.video" type="string">
      `edit`および`extend`のソースクリップです。`https` URLまたはbase64の動画
      データ URIを指定し、長さは2秒以上である必要があります。入力として秒単位で課金されます。
    </ParamField>

    <ParamField body="input.reference_images" type="string[]">
      モデルがスタイルと主題の参考にする画像を最大3枚指定します。出力は
      `720p`を上限とします。`input.images`とは併用できません。
    </ParamField>

    <ParamField body="input.voice_ids" type="string[]">
      最大3つのプリセット音声を指定できますが、`grok-imagine-video-1.5`でのみ使用できます。値は
      送信時には検証されないため、名前が正しくない場合は後でタスクが失敗します。
    </ParamField>

    <ParamField body="input.generate_audio" type="boolean" default="true">
      無音クリップにするには`false`を設定します。料金は変わりません。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="callback_url" type="string">
  完了したタスクをPOSTする`https` URLです。これによりポーリングを省略できます。
  動画には20～50秒かかるため、コールバックを設定しておく価値があります。
</ParamField>

## 返ってくる内容

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

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

<ResponseExample>
  ```json 応答 theme={null}
  {
    "id": "task_IIISyUlKs0fJDptkSCLbcJvXWZLpECKM",
    "status": "queued",
    "created_at": 1788189046
  }
  ```
</ResponseExample>

## その後、結果をポーリングします

このプレイグラウンドでは作成呼び出しのみを扱います。上記のレスポンスから`id`を取得し、`status`が`completed`または`failed`に達するまでタスクを読み取ります。長さと解像度に応じて、20～50秒かかる見込みです。

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

完了したタスクには、1つのMP4を格納した`outputs`配列が含まれます。

```json theme={null}
{
  "id": "task_IIISyUlKs0fJDptkSCLbcJvXWZLpECKM",
  "model": "grok-imagine-video",
  "status": "completed",
  "created_at": 1788189046,
  "completed_at": 1788189065,
  "expires_at": 1788275465,
  "outputs": ["https://r2cdn.agisuitepro.com/o/2026/08/31/task_IIISyUlKs0fJDptkSCLbcJvXWZLpECKM_0.mp4"],
  "counts": { "requested": 1, "succeeded": 1, "failed": 0 },
  "usage": { "cost_in_usd_ticks": 500000000 }
}
```

ファイルは`video/mp4`として提供され、インラインで再生されます。再生時間は、指定した時間より約0.04秒長くなります。

<Info>
  出力URLには認証がなく、タスクの完了から24時間後に期限切れになります。
  `usage.cost_in_usd_ticks`は**定価**です。残高からは、その金額にグループのレート倍率を掛けた額が差し引かれます。詳しくは
  [価格](/ja/models/grok-imagine/video/overview#pricing)をご覧ください。
</Info>

## 次のステップ

<CardGroup cols={2}>
  <Card title="概要" icon="film" href="/ja/models/grok-imagine/video/overview">
    モード、期間と解像度のティア、参照画像、音声、料金について説明します。
  </Card>

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