Stack de développeurs Image2URL

SDK + CLI pour URLs d'images instantanées

Paquets officiels derrière image2url.com : imgtourl (CLI), mcp-server-image2url (agents), @image2url/react (UI) et @image2url/next (assistants API). Uploadez une fois, partagez partout.

CDN Global

Cache edge

Sécurité

TLS + vérifications MIME

Niveau gratuit

Quotas basés IP

Prêt EEAT : limites transparents, HTTPS par défaut, stockage Cloudflare R2, et sorties structurées pour workflows reproductibles.

Uploads signés, en-têtes cache et assainissement nom de fichier intégrés.
Simulateur de terminal web

Tapez npm install -g imgtourl et appuyez sur Entrée pour simuler.

Étape 1 : simuler installation. Étape 2 : essayez imgtourl logo.png pour un upload avec sortie URL verte.

Ligne SDK

Réponses cohérentes sur CLI, MCP, React et Next.js.

imgtourl (CLI)

CLI globale sans configuration. Convertit tout chemin fichier en URL supportée CDN.

$ npm install -g imgtourl
imgtourl hero.png

Idéal pour scripts CI, auteurs docs et uploads rapides terminal.

mcp-server-image2url

Serveur MCP plug-and-play pour Claude ou tout client MCP.

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

Retourne URL + fragments Markdown/HTML/BBCode dans sortie MCP structurée.

@image2url/react

Hook React pour uploads drag-and-drop avec état progression.

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

Amical client, fonctionne avec fetch, garde bundle petit.

@image2url/next

Assistant server-first qui signe et stream les uploads dans routes Next.js.

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

API Route / Route Handler prêt ; cache et force limites taille.

Démarrage rapide React

Amélioration progressive : hook plug-and-play plus drag-and-drop. Gardez uploads hors backend ou override endpoint pour déploiements privés.

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

Gardez uploads server-side pour éviter exposer tokens. Fonctionne dans API Routes ou Route Handlers avec réponses streaming et en-têtes 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: 'Fichier manquant' }, { status: 400 });
  }

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

  return NextResponse.json(result);
}

Sécurité et confiance

HTTPS par défaut, validation MIME, encodage nom fichier et en-têtes Cache-Control optimisés CDN. Erreurs structurées rendent observabilité facile.

Prêt SEO et embeds

Les liens sont CDN-cachés et stables, parfaits pour blogs, docs, wikis et embeds sociaux sans gonflement base64.

Sortie cohérente

Chaque paquet retourne URL, Markdown, HTML, BBCode, filename, mimeType et uploadedAt pour que vos workflows restent déterministes.

FAQ

Qu'est-ce qu'Image2URL ?

Image2URL convertit tout fichier ou URL image distante en lien HTTPS permanent plus fragments Markdown/HTML. Le stack SDK enveloppe cet endpoint pour CLI, MCP, React et Next.js.

Y a-t-il un niveau gratuit ?

Oui. L'endpoint par défaut sur image2url.com fournit quota gratuit basé IP pour que vous puissiez tester localement sans tokens.

Puis-je auto-héberger ?

Définissez IMAGE2URL_BASE_URL ou IMAGE2URL_UPLOAD_URL pour pointer vers votre déploiement ou bucket Cloudflare R2. CLI, serveur MCP et SDKs respectent ces variables d'environnement.

Quels formats sont retournés ?

URL directe plus chaînes Markdown, HTML et BBCode. Les réponses structurées incluent filename, mimeType, taille, uploadedAt et uploadEndpoint.

Comment les fichiers sont-ils validés ?

Les images doivent présenter un type MIME image/* valide. La limite taille par défaut est 2 MB ; vous pouvez override via IMAGE2URL_MAX_BYTES dans déploiements auto-hébergés.

Le SDK est-il prêt pour production ?

Oui. Construit sur HTTPS avec en-têtes cache-friendly, vérifications intégrité et messages d'erreur clairs. Utilisé par image2url.com lui-même.

Image2URL SDKs & CLI | imgtourl, Serveur MCP, Paquets React et Next.js