Стек разработчиков Image2URL

SDK + CLI для мгновенных URL изображений

Официальные пакеты за image2url.com: imgtourl (CLI), mcp-server-image2url (агенты), @image2url/react (UI) и @image2url/next (помощники API). Загрузите один раз, делитесь везде.

Глобальный CDN

Edge-кеш

Безопасность

TLS + MIME проверки

Бесплатный уровень

Квоты на основе IP

EEAT-ready: прозрачные лимиты, HTTPS по умолчанию, хранилище Cloudflare R2 и структурированные выходы для воспроизводимых workflows.

Подписанные загрузки, заголовки кэша и очистка имен файлов встроены.
Симулятор веб-терминала

Введите npm install -g imgtourl и нажмите Enter для симуляции.

Шаг 1: симулировать установку. Шаг 2: попробуйте imgtourl logo.png для загрузки с зеленым выводом URL.

Линия SDK

Согласованные ответы в CLI, MCP, React и Next.js.

imgtourl (CLI)

Глобальная CLI без конфигурации. Превращает любой путь файла в URL с поддержкой CDN.

$ npm install -g imgtourl
imgtourl hero.png

Идеально для CI скриптов, авторов документации и быстрых загрузок в терминале.

mcp-server-image2url

Подключаемый MCP сервер для Claude или любого MCP клиента.

$ npx -y mcp-server-image2url
upload_image {"path": "/tmp/screenshot.png"}

Возвращает URL + фрагменты Markdown/HTML/BBCode в структурированном выводе MCP.

@image2url/react

React hook для загрузок drag-and-drop со статусом прогресса.

$ npm install @image2url/react
const { upload, status } = useImage2URL();

Дружественный к клиенту, работает с fetch, сохраняет пакет небольшим.

@image2url/next

Помощник server-first, который подписывает и стримит загрузки внутри маршрутов Next.js.

$ npm install @image2url/next
await uploadImage({ file, alt })

API Route / Route Handler готов; кэширует и применяет ограничения размера.

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

Постепенное улучшение: подключаемый hook плюс drag-and-drop. Держите загрузки вне вашего бэкенда или переопределите endpoint для приватных развертываний.

import { useImage2URL } from '@image2url/react';

export function ImageUploader() {
  const { upload, status, result, error } = useImage2URL({
    uploadUrl: 'https://www.image2url.com/api/upload',
  });

  async function handleFile(file) {
    await upload({ file, alt: 'hero banner' });
  }

  return (
    <div>
      <input type="file" accept="image/*" onChange={(e) => e.target.files && handleFile(e.target.files[0])} />
      <p>{status === 'uploading' ? 'Загрузка…' : null}</p>
      {result?.url && <a href={result.url}>{result.url}</a>}
      {error && <span>{error}</span>}
    </div>
  );
}
Route Handler Next.js

Держите загрузки server-side чтобы не раскрывать токены. Работает в API Routes или Route Handlers с потоковыми ответами и заголовками кэша.

import { uploadImage } from '@image2url/next';
import { NextResponse } from 'next/server';

export async function POST(request: Request) {
  const data = await request.formData();
  const file = data.get('file');

  if (!(file instanceof File)) {
    return NextResponse.json({ error: 'Файл отсутствует' }, { status: 400 });
  }

  const result = await uploadImage({
    file,
    alt: 'marketing-banner',
    endpoint: 'https://www.image2url.com/api/upload',
  });

  return NextResponse.json(result);
}

Безопасность и доверие

HTTPS по умолчанию, валидация MIME, кодирование имени файла и заголовки Cache-Control оптимизированные для CDN. Структурированные ошибки делают наблюдаемость простой.

Готов для SEO и встраиваний

Ссылки кэшированы в CDN и стабильны, идеальны для блогов, документации, wiki и социальных встраиваний без раздувания base64.

Согласованный вывод

Каждый пакет возвращает URL, Markdown, HTML, BBCode, filename, mimeType и uploadedAt чтобы ваши workflows оставались детерминированными.

FAQ

Что такое Image2URL?

Image2URL превращает любой файл или удаленный URL изображения в постоянную HTTPS ссылку плюс фрагменты Markdown/HTML. Стек SDK оборачивает этот endpoint для CLI, MCP, React и Next.js.

Есть бесплатный уровень?

Да. Endpoint по умолчанию на image2url.com предоставляет бесплатную квоту на основе IP чтобы вы могли тестировать локально без токенов.

Можно ли самостоятельно размещать?

Установите IMAGE2URL_BASE_URL или IMAGE2URL_UPLOAD_URL чтобы указать на ваше собственное развертывание или bucket Cloudflare R2. CLI, MCP сервер и SDK соблюдают эти переменные окружения.

Какие форматы возвращаются?

Прямой URL плюс строки Markdown, HTML и BBCode. Структурированные ответы включают filename, mimeType, размер, uploadedAt и uploadEndpoint.

Как файлы валидируются?

Изображения должны представлять действительный тип MIME image/*. Ограничение размера по умолчанию 2 MB; вы можете переопределить через IMAGE2URL_MAX_BYTES в самостоятельно размещенных развертываниях.

SDK готов к продакшену?

Да. Построен на HTTPS с дружественными к кэшу заголовками, проверками целостности и ясными сообщениями об ошибках. Используется самим image2url.com.

Image2URL SDKs & CLI | imgtourl, MCP сервер, пакеты React и Next.js