СправочникGPT Image 2.5 Стабильно

Руководство по API студии TopviewAI Pro

Управляйте API-ключами и изучайте запросы студии после входа. Пример ниже использует GPT Image 2.5; у других моделей собственные форматы запросов.

https://topviewai.pro

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

Только два шага до первого вызова API: отправьте задачу и затем запрашивайте статус.

Отправить задачу

Отправьте POST запрос на generate и получите Task ID.

Проверить статус

Используйте Task ID для проверки прогресса, пока не получите URL изображения.

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

Эти эндпоинты студии требуют активного сеанса и API-ключа. Одного Bearer-ключа недостаточно. Храните ключ в секрете.

HTTP-заголовок

Authorization: Bearer {YOUR_API_KEY}

POST

https://topviewai.pro/api/image/gpt-image-2-5/generate

Отправьте запрос изображения GPT Image 2.5. Ответ содержит task_id; получите результат через соответствующий эндпоинт статуса.

Запрос асинхронный: сохраните task_id и опрашивайте статус до SUCCESS или конечной ошибки.

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

Имя параметра	Тип	Обязательно	Описание
`prompt`	string	Да	Опишите изображение: от 1 до 20 000 символов.
`aspect_ratio`	string	Нет	Необязательное соотношение сторон; по умолчанию auto. Примеры: 1:1, 4:3, 3:4, 16:9, 9:16.

Ответ (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://topviewai.pro/api/image/gpt-image-2-5/status

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

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

Имя параметра	Обязательно	Описание
`task_id`	Да	ID, возвращенный при отправке задачи.

Пример ответа

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "Закат над горами",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

Биллинг

Пример стоимости GPT Image 2.5

4 кредитов / изображение 1K

Стоимость зависит от модели, разрешения и настроек. Проверяйте оценку в студии и расход, указанный в задаче.

Обработка ошибок

401 UnauthorizedНеверный API Key
402 Payment RequiredНедостаточно средств
429 Too Many RequestsПревышен лимит запросов

О TopviewAI Pro

Единая студия для видео, изображений, редактирования, речи и аудио.

Выбирайте модель для каждой задачи

Используйте Seedance 2.5 для видео, GPT Image 2.5 для изображений и другие модели студии. Все названия настоящие.

Общий баланс, стоимость по модели

Выберите подписку или разовое пополнение по мере использования. Кредиты оплачивают используемые модели и инструменты.

Инструменты изображений Видеоинструменты