Главная / Информация

API Image to Text – Инструкция

API Host Company

2024-03-11

Для доступа к API необходимо пополнить баланс и скопировать Api_key из меню настроек в личном кабинете.
(Меню с настройками доступно только в ПК версии сайта.)

Стоимость использования согласно общим тарифам – 6 руб. за запрос.
API-ключ не имеет срока действия для простоты аутентификации, но в целях безопасности есть возможность перегенерировать ключ в личном кабинете.
Полученный API-ключ указывается в header запроса для дальнейшей работы.

Кастомный запрос к изображению

В некоторых ситуациях может потребоваться получение более краткого изложения или, напротив, подробной статьи, выполнение подсчета объектов, определение цветов итд.
Для этих целей предусмотрена возможность использования параметра запроса ‘text’, который позволяет задать конкретные инструкции по обработке информации, извлеченной из изображения.

Пример такой инструкции может звучать следующим образом: “Составьте статью на основе данных, полученных из изображения, объемом от 3 до 5 абзацев, в нарративном стиле. Сделай список преимуществ товара представленного на изображении”.
Этот подход позволяет гибко адаптировать вывод информации к вашим потребностям.

Пример кода на Python для отправки текста и проверки запроса в colab.research.google.com

import requests
import json

# URL и авторизационный токен запроса (получить в личном кабинете https://apihost.ru/account.php)
url = 'https://apihost.ru/api/vision'
headers = {
    'Authorization': 'Bearer eJu6o2Gz55HcJwTmuoBrOrj404FnFCS4',
}

# Открытие файла для отправки
file_path = '/content/Vanna.jpeg'  # Укажите правильный путь к файлу, в данном примере файл был загружен в colab
with open(file_path, 'rb') as file_to_upload:
    files = {
        'text': (None, ''), # В параметре можно указать текст запроса к картинке. По умолчанию выводится информация о том, что изображено на фото.
        'upfile': file_to_upload
    }

    # Выполнение запроса
    response = requests.post(url, headers=headers, files=files)

# Так как файл был открыт с использованием контекстного менеджера (with), он будет автоматически закрыт после выхода из блока with.

# Декодирование ответа из JSON
data = response.json()

# Вывод декодированного ответа
print(data)

import requests

import json

# URL и авторизационный токен запроса (получить в личном кабинете https://apihost.ru/account.php)

url = 'https://apihost.ru/api/vision'

headers = {

'Authorization': 'Bearer eJu6o2Gz55HcJwTmuoBrOrj404FnFCS4',

}

# Открытие файла для отправки

file_path = '/content/Vanna.jpeg' # Укажите правильный путь к файлу, в данном примере файл был загружен в colab

with open(file_path, 'rb') as file_to_upload:

files = {

'text': (None, ''), # В параметре можно указать текст запроса к картинке. По умолчанию выводится информация о том, что изображено на фото.

'upfile': file_to_upload

}

# Выполнение запроса

response = requests.post(url, headers=headers, files=files)

# Так как файл был открыт с использованием контекстного менеджера (with), он будет автоматически закрыт после выхода из блока with.

# Декодирование ответа из JSON

data = response.json()

# Вывод декодированного ответа

print(data)

Готовый пример использования API Image To Text на PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://apihost.ru/api/vision',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 0,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('text' => '', 'upfile'=> new CURLFILE('/home/hugo/Downloads/Без названия.jpeg')),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer qHfhVM7tREGwergin2iPaHRqert32',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

<?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL => 'https://apihost.ru/api/vision',

CURLOPT_RETURNTRANSFER => true,

CURLOPT_ENCODING => '',

CURLOPT_MAXREDIRS => 0,

CURLOPT_TIMEOUT => 0,

CURLOPT_FOLLOWLOCATION => true,

CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,

CURLOPT_CUSTOMREQUEST => 'POST',

CURLOPT_POSTFIELDS => array('text' => '', 'upfile'=> new CURLFILE('/home/hugo/Downloads/Без названия.jpeg')),

CURLOPT_HTTPHEADER => array(

'Authorization: Bearer qHfhVM7tREGwergin2iPaHRqert32',

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;