/create

Для удаления фона с фотографии вам нужно отправить изображение в наш API. Вы можете отправить его в виде ссылки или в image/base64 и они должны быть обязательно в форматах PNG или JPEG.

Чтобы отправлять авторизованные запросы нужно получить API ключ, как это сделать написано в разделе С чего начать?

Рассмотрим пример, где мы хотим удалить фон на фотографии:

Как удалить фон на фотографии через API

Создать задачу на удаление фона

POST https://gptunnel.ru/v1/bgremover/create

Удаление фона с использованием нашего ИИ может занимать от 1 до 30 секунд в зависимости от загрузки сервера, поэтому мы создаем асинхронные задачи и получаем результат по мере готовности через webhook либо дополнительный запрос.

Headers

Name	Type	Description
Authorization*	string	API ключ

Request Body

Name	Type	Description
sourceImage*	string	png or jpeg
useWalletBalance	bool	Использовать личный счет
webhook	string	URL для отправки результата

200: OK Успешный ответ

{
	"id": "65819c485337280001a609e7",
	"parentId": null,
	"object": "task",
	"type": "@BGRemover",
	"percent": 0,
	"status": "idle",
	"error": null,
	"usage": {
		"prompt_tokens": 0,
		"completion_tokens": 1,
		"total_tokens": 1,
		"prompt_cost": 0,
		"completion_cost": 10,
		"total_cost": 10
	}
}

400: Bad Request Неверный запрос

402: Payment Required Недостаточно средств

401: Unauthorized Ошибка авторизации

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

NodeJS

import axios from 'axios'

const request = axios({
  method: 'POST',
  url: 'https://gptunnel.ru/v1/bgremover/create',
  headers: {
    // use your API key here
    Authorization: 'YOUR_API_KEY',
  },
  data: {
    sourceImage: "https://storage.yandexcloud.net/timenote/photo_bgremover_original.webp",
    webhook: null,
    useWalletBalance: false
  }
})

request.then((result) => {
  console.log(result)
}).catch((error) => {
  console.error(error)
})

Curl

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

{
	"id": "65819c485337280001a609e7",
	"parentId": null,
	"object": "task",
	"type": "@BGRemover",
	"percent": 0,
	"status": "idle",
	"error": null,
	"usage": {
		"prompt_tokens": 0,
		"completion_tokens": 1,
		"total_tokens": 1,
		"prompt_cost": 0,
		"completion_cost": 10,
		"total_cost": 10
	}
}

Результат будет получен через webhook, который был указан в запросе, или через метод /result. Информацию о методе /result можно найти на следующей странице.