Skip to main content
POST
Песочница
Введите свой API key и промпт, затем отправьте запрос. Это обращение к рабочему API — к тому же эндпоинту, который будет вызывать ваш код.
Запросы, отправленные с этой страницы, являются реальными и тарифицируются по вашему ключу. Одно изображение стоит от $0.02 до $0.08 в зависимости от модели и уровня. Здесь нет ни песочницы, ни имитации.

Параметры

string
обязательно
Модель для запуска. Принимает grok-imagine-image, grok-imagine-image-2.0 или grok-imagine-image-quality в точном соответствии — псевдонимы не поддерживаются.
object
обязательно
Параметры генерации. Любой ключ, не указанный ниже, отклоняется с invalid_params.
string
URL https, на который следует отправить POST-запрос с завершённой задачей, чтобы пропустить опрос. Должен быть https — всё остальное отклоняется во время отправки.

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

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

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

Эта песочница охватывает только вызов создания. Возьмите id из приведённого выше ответа и считывайте задачу, пока status не достигнет значения completed или failed — это займёт примерно от 7 до 10 секунд.
Завершённая задача содержит массив outputs:
URL результатов не требуют аутентификации и становятся недействительными через 24 часа после завершения задачи. usage.cost_in_usd_ticks — это публичная цена; ваш баланс изменяется на эту сумму, умноженную на коэффициент тарифа вашей группы — см. тарификацию.

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

Обзор

Все параметры, сетка разрешений и качества, а также измеренная задержка.

API асинхронных задач

Цикл опроса, обратные вызовы и полная таблица ошибок.