Runbase

Command Palette

Search for a command to run...

OpenAI

GPT Image 2

ID:openai/gpt-image-2

GPT Image 2 — API генерации изображений от OpenAI. Разрешение до 4K со встроенным рассуждением, многоязычным рендерингом текста и редактированием по референсам.

Текст в изображениеРедактирование изображенийРеференсные изображенияКоммерческое использование

Обзор

GPT Image 2 — API генерации изображений от OpenAI. Разрешение до 4K со встроенным рассуждением, многоязычным рендерингом текста и редактированием по референсам.

Аутентификация

Все API-запросы требуют валидный API-ключ, переданный в заголовке Authorization по схеме Bearer.

Быстрый старт

Учётные данные

Задайте переменную окружения RUNBASE_API_KEY.

Shell
export RUNBASE_API_KEY=your-api-key

Создать запуск

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Запуски

Запуски обрабатываются асинхронно. Отправьте запрос, затем опрашивайте статус для получения результата.

Создать запуск

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Получить статус запуска

Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Получить результат

Опрашивайте эндпоинт статуса, пока status не станет "succeeded", затем прочитайте output.urls из ответа.

Схема входных данных

ПараметрТипОбязательныйОписание
promptstringОбязательныйPrompt
aspect_ratiostringНеобязательныйAspect ratioПараметры: 1:12:33:23:44:34:55:49:1616:921:9
resolutionstringНеобязательныйResolutionПараметры: 1K2K4K
image_urlsstring[]НеобязательныйReference images

Схема выходных данных

ПолеТипОписание
urlsstring[]URL сгенерированных результатов

Ошибки

API использует стандартные HTTP-коды для индикации успеха или ошибки.

Код статусаОписание
400잘못된 요청 - 매개변수가 누락되었거나 형식이 올바르지 않습니다
401인증 실패 - API 키가 누락되었거나 유효하지 않습니다
402크레딧 부족
403접근 거부 - IP가 허용되지 않았거나 API 키 지출 한도 초과
404실행을 찾을 수 없습니다
429요청 속도 제한 초과
500내부 서버 오류