API-документация

Подробное подключение Task API для GPT Image 2.5 Flare Text-to-Image

API-документация

Эндпоинт

Базовый URLhttps://api.mashagpt.ru/v1

Эндпоинт

POST

/v1/tasks/gpt-image-2-5-flare-text-to-image

Авторизация

x-api-key: YOUR_API_KEY

илиAuthorization: Bearer YOUR_API_KEY

Параметры запроса

ПараметрТипОписание

prompt*

stringText prompt describing the desired image (max 20000 characters). Пример — A cinematic night city poster with neon reflections on a rainy street.

aspectRatio

stringДопустимые значения: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9. Output aspect ratio. По умолчанию — auto.

resolution

stringДопустимые значения: 1K, 2K, 4K. 1K, 2K or 4K. Every aspect ratio this model offers supports all three — verified against the live provider. По умолчанию — 1K.

Пример запроса и ответа

Запрос

curl -X POST https://api.mashagpt.ru/v1/tasks/gpt-image-2-5-flare-text-to-image \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "prompt": "A cinematic night city poster with neon reflections on a rainy street",
  "aspectRatio": "auto",
  "resolution": "1K"
}'

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "550e8400-e29b-41d4-a716-446655440000",
    "state": "queued"
  }
}

Асинхронная обработка

Модель работает асинхронно. После запроса вы получите taskId задачи для отслеживания статуса.

GET

/v1/tasks/{id}статус задачи

Проверка статуса задачи:

curl -X GET "https://api.mashagpt.ru/v1/tasks/{task_id}" \
  -H "x-api-key: YOUR_API_KEY"

Жизненный цикл задачи:

queued→processing→completed|failed

API-документация

Эндпоинт

Базовый URLhttps://api.mashagpt.ru/v1

Эндпоинт

POST

/v1/tasks/gpt-image-2-5-flare-text-to-image

Авторизация

x-api-key: YOUR_API_KEY

илиAuthorization: Bearer YOUR_API_KEY

Параметры запроса

ПараметрТипОписание

prompt*

stringText prompt describing the desired image (max 20000 characters). Пример — A cinematic night city poster with neon reflections on a rainy street.

aspectRatio

stringДопустимые значения: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9. Output aspect ratio. По умолчанию — auto.

resolution

stringДопустимые значения: 1K, 2K, 4K. 1K, 2K or 4K. Every aspect ratio this model offers supports all three — verified against the live provider. По умолчанию — 1K.

Пример запроса и ответа

Запрос

curl -X POST https://api.mashagpt.ru/v1/tasks/gpt-image-2-5-flare-text-to-image \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "prompt": "A cinematic night city poster with neon reflections on a rainy street",
  "aspectRatio": "auto",
  "resolution": "1K"
}'

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "550e8400-e29b-41d4-a716-446655440000",
    "state": "queued"
  }
}

Асинхронная обработка

Модель работает асинхронно. После запроса вы получите taskId задачи для отслеживания статуса.

GET

/v1/tasks/{id}статус задачи

Проверка статуса задачи:

curl -X GET "https://api.mashagpt.ru/v1/tasks/{task_id}" \
  -H "x-api-key: YOUR_API_KEY"

Жизненный цикл задачи:

queued→processing→completed|failed