> ## 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 состоит из одних и тех же трёх шагов независимо от того, выполняете ли вы генерацию изображения или видео и какую модель выбираете.

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

Вызов немедленно возвращает идентификатор задачи. Генерация выполняется в фоновом режиме.

## Опрос до завершения

Опросите эндпоинт задачи с увеличением интервала до тех пор, пока статус не достигнет конечного состояния,\
затем скачайте всё, что создала задача.

<Warning>
  Выполняйте опрос с увеличением интервала, а не в плотном цикле. Начните примерно с двух секунд и увеличивайте
  интервал; клиент, который выполняет опрос каждые 100 мс, получит ограничение лимитом запросов, не завершив задачу быстрее.
</Warning>

## Следующие шаги

<CardGroup cols={2}>
  <Card title="Модели" icon="layers">
    Какие параметры принимает каждая модель и какие значения используются по умолчанию.
  </Card>

  <Card title="Справочник API" icon="terminal">
    Полные схемы запросов и ответов с интерактивной песочницей.
  </Card>
</CardGroup>