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

# クイックスタート

> 最初の生成タスクを送信し、完了するまでポーリングして、結果をダウンロードします。

WideRouter のすべてのジョブは、画像を生成する場合でも動画を生成する場合でも、また選択するモデルにかかわらず、同じ 3 つの手順に従います。

<Info>
  **スキャフォールドに関する注意。** 以下のエンドポイントパスとフィールド名は、リポジトリのブートストラップ時に使用されたプレースホルダーです。
  実際の API 仕様に置き換えてから、ローカライズ済みページを再生成してください。
</Info>

## APIキーを取得する

コンソールでキーを作成し、以下の例で読み取れるようにエクスポートします。
コミットするファイルにキーを直接ハードコードしないでください。

```bash theme={null}
export WIDEROUTER_API_KEY="sk-your-api-key"
```

## タスクを作成する

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.widerouter.com/v1/tasks \
    -H "Authorization: Bearer $WIDEROUTER_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-model-id",
      "prompt": "a lighthouse at dusk"
    }'
  ```

  ```python Python theme={null}
  import os, requests

  resp = requests.post(
      "https://api.widerouter.com/v1/tasks",
      headers={"Authorization": f"Bearer {os.environ['WIDEROUTER_API_KEY']}"},
      json={"model": "your-model-id", "prompt": "a lighthouse at dusk"},
      timeout=30,
  )
  task_id = resp.json()["id"]
  ```
</CodeGroup>

呼び出しはタスク ID をすぐに返します。生成はバックグラウンドで行われます。

## 完了するまでポーリング

ステータスが終端状態に達するまで、バックオフしながらタスクのエンドポイントをポーリングし、その後、タスクによって生成されたものをダウンロードします。

<Warning>
  タイトなループではなく、バックオフしながらポーリングします。まずは約 2 秒から開始して間隔を徐々に延ばしてください。100 ミリ秒ごとにポーリングするビジー状態のクライアントは、完了までの時間が短縮されないままレート制限を受けます。
</Warning>

## 次のステップ

<CardGroup cols={2}>
  <Card title="モデル" icon="layers">
    各モデルが受け付けるパラメータと、そのデフォルト値。
  </Card>

  <Card title="API リファレンス" icon="terminal">
    インタラクティブなプレイグラウンドを備えた、リクエストとレスポンスの完全なスキーマ。
  </Card>
</CardGroup>