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

# Песочница

> Отправьте реальную задачу генерации с этой страницы, а затем проверяйте её состояние с помощью возвращённого идентификатора задачи.

Введите API-ключ и промпт, затем отправьте запрос. Это обращение к рабочему API — к тому же эндпоинту, который будет вызывать ваш код.

<Warning>
  **Запросы, отправленные с этой страницы, являются реальными и тарифицируются для вашего ключа.**
  Одно изображение 1K стоит примерно \$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="входные данные">
    <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 или URI данных в формате base64.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="callback_url" type="string">
  URL `https`, на который необходимо отправить готовую задачу методом POST, чтобы пропустить опрос. Должен быть
  `https` — любое другое значение будет отклонено во время отправки.
</ParamField>

## Что возвращается

Отправка возвращает результат сразу, значительно меньше чем за секунду. Изображения **нет** в этом ответе — генерация выполняется в фоновом режиме.

| Поле         | Тип     | Примечания                                               |
| ------------ | ------- | -------------------------------------------------------- |
| `id`         | string  | Идентификатор задачи. Всё остальное требует его наличия. |
| `status`     | string  | `queued` для новой задачи.                               |
| `created_at` | integer | Секунды Unix, UTC.                                       |

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

## Затем запросите результат генерации изображения

Этот playground охватывает только запрос на создание. Возьмите `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"
```

Завершённая задача содержит массив `outputs` с URL изображений:

```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="/ru/models/nano-banana/overview">
    Все параметры, уровни разрешения и измеренная задержка для серии.
  </Card>

  <Card title="API асинхронных задач" icon="clock" href="/ru/api/async-tasks">
    Цикл опроса, обратные вызовы и полная таблица ошибок.
  </Card>
</CardGroup>