Stos deweloperów Image2URL

SDK + CLI dla natychmiastowych URL-ów obrazów

Oficjalne pakiety za image2url.com: imgtourl (CLI), mcp-server-image2url (agenci), @image2url/react (UI) i @image2url/next (pomocnicy API). Prześlij raz, udostępnij wszędzie.

Globalne CDN

Cache edge

Bezpieczeństwo

TLS + sprawdzanie MIME

Poziom darmowy

Kwoty oparte na IP

Gotowy EEAT: przezroczyste limity, domyślnie HTTPS, przechowywanie Cloudflare R2 i strukturalne wyjścia dla odtwarzalnych workflow.

Podpisane przesyłania, nagłówki cache i sanityzacja nazw plików wbudowane.
Symulator terminala web

Wpisz npm install -g imgtourl i naciśnij Enter do symulacji.

Krok 1: symuluj instalację. Krok 2: spróbuj imgtourl logo.png dla przesyłania z zielonym wyjściem URL.

Linia SDK

Spójne odpowiedzi przez CLI, MCP, React i Next.js.

imgtourl (CLI)

Globalna CLI bez konfiguracji. Zamienia dowolną ścieżkę pliku na URL wspierany przez CDN.

$ npm install -g imgtourl
imgtourl hero.png

Idealny dla CI scripts, autorów dokumentów i szybkich przesyłań w terminalu.

mcp-server-image2url

Serwer MCP plug-and-play dla Claude lub każdego klienta MCP.

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

Zwraca URL + fragmenty Markdown/HTML/BBCode w strukturalnym wyjściu MCP.

@image2url/react

Hook React dla przesyłań drag-and-drop ze statusem postępu.

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

Przyjazny dla klienta, działa z fetch, utrzymuje mały pakiet.

@image2url/next

Pomocnik server-first który podpisuje i strumieniuje przesyłania wewnątrz tras Next.js.

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

API Route / Route Handler gotowy; cache i wymusza limity rozmiaru.

Szybki start React

Stopniowa poprawa: drop-in hook plus drag-and-drop. Utrzymuj przesyłania z dala od backendu lub override endpoint dla prywatnych wdrożeń.

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' ? 'Przesyłanie…' : null}</p>
      {result?.url && <a href={result.url}>{result.url}</a>}
      {error && <span>{error}</span>}
    </div>
  );
}
Route Handler Next.js

Utrzymuj przesyłania po stronie serwera aby nie ujawnić tokenów. Działa w API Routes lub Route Handlers z odpowiedziami streaming i nagłówkami cache.

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: 'Brak pliku' }, { status: 400 });
  }

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

  return NextResponse.json(result);
}

Bezpieczeństwo i zaufanie

Domyślnie HTTPS, walidacja MIME, kodowanie nazw plików i nagłówki Cache-Control zoptymalizowane dla CDN. Strukturalne błędy ułatwiają obserwowalność.

Gotowy SEO i embeds

Linki są cacheowane przez CDN i stabilne, idealne dla blogów, dokumentów, wiki i embedów społecznościowych bez rozdęcia base64.

Spójne wyjście

Każdy pakiet zwraca URL, Markdown, HTML, BBCode, filename, mimeType i uploadedAt aby Twoje workflow pozostały deterministyczne.

FAQ

Co to jest Image2URL?

Image2URL zamienia dowolny plik lub URL obrazu zdalnego na stały link HTTPS plus fragmenty Markdown/HTML. Stos SDK owija ten endpoint dla CLI, MCP, React i Next.js.

Czy jest darmowy poziom?

Tak. Domyślny endpoint na image2url.com oferuje darmowe kwoty oparte na IP abyś mógł lokalnie testować bez tokenów.

Czy mogę self-hostować?

Ustaw IMAGE2URL_BASE_URL lub IMAGE2URL_UPLOAD_URL aby wskazać na własne wdrożenie lub kubeł Cloudflare R2. CLI, serwer MCP i SDK respektują te zmienne środowiskowe.

Jakie formaty są zwracane?

Bezpośredni URL plus ciągi Markdown, HTML i BBCode. Strukturalne odpowiedzi obejmują filename, mimeType, rozmiar, uploadedAt i uploadEndpoint.

Jak pliki są walidowane?

Obrazy muszą prezentować ważny typ MIME image/*. Domyślny limit rozmiaru to 2 MB; możesz override przez IMAGE2URL_MAX_BYTES w self-hosted wdrożeniach.

Czy SDK jest gotowy do produkcji?

Tak. Zbudowany na HTTPS z przyjaznymi dla cache nagłówkami, sprawdzeniami integralności i jasnymi komunikatami błędów. Używany przez image2url.com sam.

Image2URL SDKs & CLI | imgtourl, MCP Serwer, Pakiety React i Next.js