SDK серверной стороны
Используйте @image2url/next для принятия файлов в Route Handlers или API Routes, отправки их в image2url и отправки кэшированных CDN ссылок за один вызов. Построен для скорости, наблюдаемости и нуля битых встраиваний.
Стратегия кэша
public, max-age=31536000
Валидация
MIME + защита размера
Форматы
URL + Markdown/HTML/BBCode
import { uploadImage } from '@image2url/next';
import { NextResponse } from 'next/server';
export async function POST(request: Request) {
const form = await request.formData();
const file = form.get('file');
if (!(file instanceof File)) {
return NextResponse.json({ error: 'Отсутствует файл' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}Безопасен по умолчанию
HTTPS загрузки, валидация MIME, ограничения размера и кодирование имен файлов. Возвращает структурированные ошибки, которые вы можете залогировать.
SEO-дружественные ссылки
Стабильные CDN URL с заголовками кэша и alt-дружественными строками использования для блогов, документации и встраиваний.
Детерминированный вывод
URL плюс строки Markdown, HTML и BBCode, плюс поля filename, mimeType, size и uploadedAt.
Загрузки серверной стороны
Храните токены на серверной стороне, передавайте файлы в Route Handlers и избегайте утечки учетных данных клиенту.
Встроенная наблюдаемость
Согласованный JSON для логирования и аналитики. Добавляйте собственные повторы или телеметрию без угадывания форм ответа.
Дружественный к edge fallback
Работает в node runtime и деградирует грациозно на edge. Настраивайте эндпоинты для каждой среды.
Кэш, которому можно доверять
Публичные, долгоживущие заголовки кэша на выходах. Идеально для документации, маркетинговых сайтов и статических рендеров.
Roadmap с открытым исходным кодом
Мы поставляем в открытом доступе. Помогите нам добавить подписанные URL, трансформации изображений и пресеты фреймворков.
Drop-in миграция
Замените ваш помощник загрузки одним вызовом; сохраните ваши формы и UI нетронутыми.
Мы собираем паттерны из реального мира: подписанные загрузки, кастомные домены CDN, примеры Next.js middleware и улучшения DX. Stars, issues и PRs на GitHub поддерживают здоровье проекта.
Предпочитаете React hooks? Попробуйте @image2url/react. Нужны потоки агентов? Используйте mcp-server-image2url.
Что решает @image2url/next?
Он сохраняет загрузки на серверной стороне в Next.js (Route Handlers или API Routes), возвращает типизированный JSON и отправляет готовые к CDN URL с фрагментами Markdown/HTML.
Нужны ли мне ключи API?
Эндпоинт по умолчанию на image2url.com предлагает бесплатную квоту на основе IP. Самостоятельно размещенные развертывания могут принуждать токены и кастомные ограничения размера.
Совместим ли с edge?
Да. Помощник работает в Route Handlers и поддерживает потоковые тела. Лучше всего работает в node runtime, но деградирует грациозно.
Могу ли я внести вклад?
Абсолютно. Мы строим публично на github.com/image2url/image2url-sdk. Issues, PRs и улучшения документации приветствуются.
Какие ответы я получаю обратно?
Постоянный URL плюс filename, mimeType, size, uploadedAt и форматированные строки (Markdown, HTML, BBCode) для мгновенной вставки.
Как обрабатывается надежность?
Загрузки HTTPS, валидированные для MIME и размера, устанавливают Cache-Control: public, max-age=31536000 и возвращают структурированные ошибки, которые вы можете залогировать.
Готов к отправке
URL, поддерживаемые CDN, типизированные ответы и roadmap, управляемый сообществом.