مكدسة Image2URL للمطورين

SDK + CLI لعناوين URL الفورية للصور

الحزم الرسمية وراء image2url.com: imgtourl (CLI)، mcp-server-image2url (الوكلاء)، @image2url/react (UI)، و @image2url/next (مساعدات API). قم بالتحميل مرة، شارك في كل مكان.

شبكة CDN عالمية

التخزين المؤقت على الحافة

الأمان

TLS + فحوص MIME

مستوى مجاني

حصص قائمة على IP

جاهز EEAT: حدود شفافة، HTTPS افتراضي، تخزين Cloudflare R2، ومخرجات منظمة لسير العمل القابل للتكرار.

تحميلات موقعة، رؤوس التخزين المؤقت، وتنظيف أسماء الملفات مدمجة.
محاكي طرفية الويب

اكتب npm install -g imgtourl واضغط Enter للمحاكاة.

الخطوة 1: محاكاة التثبيت. الخطوة 2: جرب imgtourl logo.png للتحميل مع إخراج URL أخضر.

خط SDK

استجابات متسقة عبر CLI، MCP، React، و Next.js.

imgtourl (CLI)

CLI عالمي بدون تكوين. يحول أي مسار ملف إلى URL مدعوم بشبكة CDN.

$ npm install -g imgtourl
imgtourl hero.png

مثالي لـ CI scripts، مؤلفي المستندات، والتحميلات السريعة عبر الطرفية.

mcp-server-image2url

خادم MCP جاهز للاستخدام لـ Claude أو أي عميل MCP.

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

يعرض URL + مقتطفات Markdown/HTML/BBCode في مخرجات MCP منظمة.

@image2url/react

React hook للتحميلات بالسحب والإفلات مع حالة التقدم.

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

ودي للعميل، يعمل مع fetch، يحافظ على الحجم الصغير.

@image2url/next

مساعد يركز على الخادم يقوم بالتوقيع وتدفق التحميلات داخل مسارات Next.js.

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

جاهز لـ API Route / Route Handler؛ يقوم بالتخزين المؤقت وفرض حدود الحجم.

بداية سريعة React

تحسين تدريجي: hook جاهز للاستخدام مع السحب والإفلات. احتفظ بالتحميلات بعيداً عن الخلفية أو قم بتجاوز نقطة النهاية للنشر الخاص.

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>
  );
}
معالج مسار Next.js

احتفظ بالتحميلات على جانب الخادم لتجنب كشف التوكن. يعمل في 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 ومستقرة، مثالية للمدونات، المستندات، wikis، والتضمينات الاجتماعية بدون انتفاخ base64.

مخرجات متسقة

كل حزمة تعرض URL، Markdown، HTML، BBCode، اسم الملف، mimeType، و uploadedAt حتى تظل سير العمل حتمية.

الأسئلة الشائعة

ما هو Image2URL؟

Image2URL يحول أي ملف أو URL صورة بعيد إلى رابط HTTPS دائم بالإضافة إلى مقتطفات Markdown/HTML. مكدسة SDK تلتف حول تلك النقطة لـ CLI، MCP، React، و Next.js.

هل هناك مستوى مجاني؟

نعم. نقطة النهاية الافتراضية على image2url.com توفر حصة مجانية قائمة على IP حتى تتمكن من الاختبار محلياً بدون توكن.

هل يمكنني الاستضافة الذاتية؟

قم بتعيين IMAGE2URL_BASE_URL أو IMAGE2URL_UPLOAD_URL للإشارة إلى نشر الخاص بك أو دلاء Cloudflare R2. CLI، خادم MCP، و SDK تحترم هذه متغيرات البيئة.

ما هي التنسيقات التي يتم عرضها؟

URL مباشر بالإضافة إلى سلاسل Markdown، HTML، و BBCode. الاستجابات المنظمة تشمل اسم الملف، mimeType، الحجم، uploadedAt، و uploadEndpoint.

كيف يتم التحقق من الملفات؟

يجب أن تعرض الصور نوع MIME image/* صالح. حد الحجم الافتراضي هو 2 ميجابايت؛ يمكنك تجاوزه عبر IMAGE2URL_MAX_BYTES في عمليات النشر ذاتية الاستضافة.

هل SDK جاهز للإنتاج؟

نعم. مبني على HTTPS مع رؤوس ودية للتخزين المؤقت، فحوص النزاهة، ورسائل خطأ واضحة. يستخدمه image2url.com نفسه.

Image2URL SDKs & CLI | imgtourl, MCP خادم, React و Next.js الحزم