> ## 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, а затем опрашивайте её с помощью возвращённого идентификатора задачи.

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

<Warning>
  **Запросы, отправленные с этой страницы, являются реальными и тарифицируются по вашему ключу.**
  Одно изображение стоит от \$0.02 до \$0.08 в зависимости от модели и уровня. Здесь
  нет ни песочницы, ни имитации.
</Warning>

## Параметры

<ParamField body="model" type="string" required>
  Модель для запуска. Принимает `grok-imagine-image`, `grok-imagine-image-2.0` или
  `grok-imagine-image-quality` в точном соответствии — псевдонимы не поддерживаются.
</ParamField>

<ParamField body="input" type="object" required>
  Параметры генерации. Любой ключ, не указанный ниже, отклоняется с
  `invalid_params`.

  <Expandable title="input">
    <ParamField body="input.prompt" type="string" required>
      Что нужно сгенерировать. Не должно быть пустым; не более 32000 байт.
    </ParamField>

    <ParamField body="input.resolution" type="string" default="1k">
      `1k` или `2k`. В нижнем регистре — верхний регистр отклоняется.
    </ParamField>

    <ParamField body="input.quality" type="string" default="low">
      `low` или `medium`. **Принимается только `grok-imagine-image-2.0`**; в
      двух других моделях возвращается как неизвестное поле.
    </ParamField>

    <ParamField body="input.aspect_ratio" type="string">
      Одно из значений `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` `2:1` `1:2`
      `19.5:9` `9:19.5` `20:9` `9:20` `21:9` `5:2`. Не указывайте этот параметр, чтобы использовать
      собственное кадрирование модели по умолчанию.
    </ParamField>

    <ParamField body="input.n" type="integer" default="1">
      Сколько изображений создать: от 1 до 4. Каждое изображение является отдельной записью в
      `outputs` и тарифицируется отдельно.
    </ParamField>

    <ParamField body="input.images" type="string[]">
      Эталонные изображения для редактирования или композиции, не более 3. Каждая запись представляет собой
      `https` URL или URI данных в формате base64 и добавляет около \$0.01 к стоимости.
    </ParamField>
  </Expandable>
</ParamField>

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

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

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

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

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

## Затем опрашивайте результат

Эта песочница охватывает только вызов создания. Возьмите `id` из приведённого выше ответа и считывайте задачу, пока `status` не достигнет значения `completed` или `failed` — это займёт примерно от 7 до 10 секунд.

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

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

```json theme={null}
{
  "id": "task_2wZ1SuRH4VzXxONqGrH9oCLEZiBQTAVF",
  "model": "grok-imagine-image",
  "status": "completed",
  "created_at": 1788189088,
  "completed_at": 1788189094,
  "expires_at": 1788275494,
  "outputs": ["https://r2cdn.agisuitepro.com/o/2026/08/31/task_2wZ1SuRH4VzXxONqGrH9oCLEZiBQTAVF_0.jpg"],
  "counts": { "requested": 1, "succeeded": 1, "failed": 0 },
  "usage": { "cost_in_usd_ticks": 200000000 }
}
```

<Info>
  URL результатов не требуют аутентификации и становятся недействительными через 24 часа после завершения задачи.
  `usage.cost_in_usd_ticks` — это **публичная цена**; ваш баланс изменяется на эту
  сумму, умноженную на коэффициент тарифа вашей группы — см.
  [тарификацию](/ru/models/grok-imagine/image/overview#pricing).
</Info>

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

<CardGroup cols={2}>
  <Card title="Обзор" icon="image" href="/ru/models/grok-imagine/image/overview">
    Все параметры, сетка разрешений и качества, а также измеренная задержка.
  </Card>

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