Image2URL ontwikkelaar stack

SDK + CLI voor directe image URLs

Officiële pakketten achter image2url.com: imgtourl (CLI), mcp-server-image2url (agents), @image2url/react (UI) en @image2url/next (API helpers). Upload één keer, deel overal.

Globale CDN

Edge cache

Veiligheid

TLS + MIME checks

Gratis niveau

IP-gebaseerde quota's

EEAT-ready: transparante limieten, standaard HTTPS, Cloudflare R2 opslag, en gestructureerde outputs voor reproduceerbare workflows.

Gesigneerde uploads, cache headers en filename sanitization ingebouwd.

Web Terminal Simulator

Typ npm install -g imgtourl en druk op Enter om te simuleren.

Stap 1: simuleer installatie. Stap 2: probeer imgtourl logo.png voor een upload met groene URL output.

SDK lijn

Consistente responses over CLI, MCP, React en Next.js.

imgtourl (CLI)

Zero-config globale CLI. Zet elk bestandspad om naar een CDN-ondersteunde URL.

$ npm install -g imgtourl

imgtourl hero.png

Ideaal voor CI scripts, docs auteurs en snelle terminal uploads.

mcp-server-image2url

Plug-in MCP server voor Claude of elke MCP client.

$ npx -y mcp-server-image2url

upload_image {"path": "/tmp/screenshot.png"}

Geeft URL + Markdown/HTML/BBCode snippets terug in gestructureerde MCP output.

@image2url/react

React hook voor drag-and-drop uploads met progress status.

$ npm install @image2url/react

const { upload, status } = useImage2URL();

Client-vriendelijk, werkt met fetch, houdt bundle klein.

@image2url/next

Server-first helper die uploads tekent en streamt binnen Next.js routes.

$ npm install @image2url/next

await uploadImage({ file, alt })

API Route / Route Handler ready; cache en forceert size caps.

React quick start

Progressive enhancement: drop-in hook plus drag-and-drop. Houd uploads van je backend af of override endpoint voor private deployments.

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' ? 'Uploaden…' : null}</p>
      {result?.url && <a href={result.url}>{result.url}</a>}
      {error && <span>{error}</span>}
    </div>
  );
}

Next.js Route Handler

Houd uploads server-side om tokens niet bloot te leggen. Werkt in API Routes of Route Handlers met streaming responses en cache headers.

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

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

  return NextResponse.json(result);
}

Veiligheid & vertrouwen

Standaard HTTPS, MIME validatie, filename encoding, en Cache-Control headers geoptimaliseerd voor CDN's. Gestructureerde errors maken observability eenvoudig.

SEO & embeds ready

Links zijn CDN-gecached en stabiel, perfect voor blogs, docs, wiki's en sociale embeds zonder base64 bloat.

Consistente output

Elk pakket retourneert URL, Markdown, HTML, BBCode, filename, mimeType en uploadedAt zodat je workflows deterministisch blijven.

FAQ

Wat is Image2URL?

Image2URL zet elk bestand of remote image URL om naar een permanente HTTPS link plus Markdown/HTML snippets. De SDK stack wrapt die endpoint voor CLI, MCP, React en Next.js.

Is er een gratis niveau?

Ja. De standaard endpoint op image2url.com biedt IP-gebaseerde gratis quota zodat je lokaal kunt testen zonder tokens.

Kan ik self-hosten?

Stel IMAGE2URL_BASE_URL of IMAGE2URL_UPLOAD_URL in om te verwijzen naar je eigen deployment of Cloudflare R2 bucket. CLI, MCP server en SDK's respecteren deze env vars.

Welke formaten worden teruggegeven?

Directe URL plus Markdown, HTML en BBCode strings. Gestructureerde responses omvatten filename, mimeType, grootte, uploadedAt en uploadEndpoint.

Hoe worden bestanden gevalideerd?

Afbeeldingen moeten een geldige image/* MIME type presenteren. Standaard size cap is 2 MB; je kunt override via IMAGE2URL_MAX_BYTES in self-hosted deployments.

Is de SDK productie-ready?

Ja. Gebouwd op HTTPS met cache-vriendelijke headers, integrity checks en duidelijke foutmeldingen. Gebruikt door image2url.com zelf.