Vision API

Анализируйте изображения с помощью возможностей компьютерного зрения на базе ИИ для извлечения описаний и инсайтов.

Эндпоинт

POST https://filebrain.pro/api/image/analyzer/v1/

Требования к файлам

Типы файлов

  • JPEG
  • PNG
  • WEBP
  • GIF (неанимированный)

Ограничения

  • Максимальный размер файла: 10MB
  • Одно изображение на запрос

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

Параметр Тип Обязательный Описание
prompt string Да Инструкции для анализа изображения
api_key string Да Ваш API ключ FileBrain
llm_api_key string Да Ваш API ключ LLM (поддерживается OpenAI)
model string Нет Модель для использования (например, 'gpt-4o-mini'). По умолчанию выбор системы, если не указан

Пример кода

Пример на Python
import requests

def analyze_image(image_path, prompt, api_key, llm_api_key):
    # Подготавливаем файлы и данные
    files = {
        'file': open(image_path, 'rb')
    }
    
    data = {
        'prompt': prompt,
        'api_key': api_key,
        'llm_api_key': llm_api_key,
        'model': 'gpt-4o-mini'  # Опционально
    }

    # Выполняем запрос
    response = requests.post(
        'https://filebrain.pro/api/image/analyzer/v1/',
        files=files,
        data=data
    )
    
    # Проверяем ответ
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"Ошибка: {response.status_code}, {response.text}")

# Пример использования
result = analyze_image(
    'path/to/image.jpg',
    'Проанализируйте это изображение и кратко опишите, что вы видите',
    'YOUR_FBP_ACCOUNT_API_KEY',
    'YOUR_OPENAI_API_KEY'
)

Формат ответа

Успешный ответ (200 OK)
{
    "success": true,
    "analysis": "Описание проанализированного изображения...",
    "model_used": "gpt-4o-mini"
}

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

Распространенные коды ошибок

  • 400 - Неверный запрос (отсутствующие параметры, неверный тип файла)
  • 401 - Неверный API ключ
  • 413 - Файл слишком большой (>20MB)
  • 429 - Превышен лимит запросов
  • 500 - Ошибка сервера