Стек разработчиков Image2URL
Официальные пакеты за 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.
imgtourl (CLI)
Идеально для CI скриптов, авторов документации и быстрых загрузок в терминале.
mcp-server-image2url
Возвращает URL + фрагменты Markdown/HTML/BBCode в структурированном выводе MCP.
@image2url/react
Дружественный к клиенту, работает с fetch, сохраняет пакет небольшим.
@image2url/next
API Route / Route Handler готов; кэширует и применяет ограничения размера.
Постепенное улучшение: подключаемый 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>
);
}Держите загрузки 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 оставались детерминированными.
Что такое 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.