هذا عبارة عن TypeScript SDK لواجهات برمجة تطبيقات الصور القابلة للبرمجة Picsart وواجهات برمجة تطبيقات Picsart GenAI. يمكنك بسهولة تنفيذ العديد من الإجراءات باستخدام صورك فقط عن طريق إضافة بضعة أسطر من التعليمات البرمجية إلى مشاريع JavaScript أو Typescript الخاصة بك.
لتثبيت الحزمة، قم بتشغيل الأمر التالي:
تثبيت npm - حفظ picsart-creative-apis-ts-sdk
import PicsartEnterprise من "picsart-creative-apis-ts-sdk";// احصل على مثيل لصورة APIconst imageApi = PicsartEnterprise.createImageApi('YOUR_API_KEY');// احصل على مثيل GenAI APIconst genaiApi = PicsartEnterprise.createGenAIApi('YOUR_API_KEY) ');
// من الصورة العامة urlconst imageSource = ImageApi.fromUrl('https://....');// من Picsart image idconst imageSource = ImageApi.fromImageId('your-image-id-here');// من ثنائي كونست fileContent = fs.readFileSync("examples/image.png");const imageSource = ImageApi.fromFile(fileContent);// من تيارconst readStream = fs.createReadStream("examples/image.png");const imageSource = ImageApi.fromStream(readStream);
نتيجة const = انتظار imageApi.removeBackground( new RemoveBackgroundRequest().setImage(imageSource).setBgColor("green")); console.log(result.image.url); console.log(result.metadata.creditsAvailable); console.log(result.metadata.rateLimitResetTime); console.log(result.metadata.rateLimit); console.log(result.metadata.rateLimitAvailable); console.log(result.metadata.correlationId);
نتيجة const = انتظار imageApi.adjust( new AdjustRequest().setImage(imageSource).setBrightness(90).setSharpen(40)); console.log(result.image.url);
نتيجة ثابتة = انتظار imageApi.effect( new EffectRequest().setImage(imageSource).setEffectName(EffectName.a1972)); console.log(result.image.url);
نتيجة const = انتظار imageApi.backgroundTexture( newbackgroundTextureRequest().setImage(imageSource).setPattern(TexturePattern.diamond).setHeight(800)); console.log(result.image.url);
نتيجة const = انتظار imageApi.effectPreviews( new EffectPreviewsRequest().setImage(imageSource).addEffect(EffectName.a1972).addEffect(EffectName.brnz2).addEffect(EffectName.icy3).addEffect(EffectName.apr3),); console.log(result.thumbnails);
نتيجة ثابتة = انتظار imageApi .enhanceFace(new EnhanceFaceRequest() .setImage(imageSource), ); console.log(result.image.url);
نتيجة const = انتظار imageApi.getBalance(); console.log(result.credits);
نتيجة const = انتظار imageApi.getEffects(); console.log(result.effets)
نتيجة ثابتة = انتظار imageApi.surfacemap( new SurfacemapRequest().setImage(imageSource1).setMask(imageSource2).setSticker(imageSource3)); console.log(result.image.url);
نتيجة const = انتظار genaiApi.text2Image( new Text2ImageRequest().setCount(10).setPrompt("الترميز طوال الوقت").setNegativePrompt("الاسترخاء والراحة")); console.log(result.images);
const fileContent = readFileSync("examples/image.png"); const blob = new Blob([fileContent]); const imageSource = ImageApi.fromFile(blob); نتيجة const = انتظار imageApi.upload(new UploadRequest() .setImage(imageSource) ); console.log(result.image.url);
نتيجة ثابتة = انتظار imageApi.upscale(new UpscaleRequest() .setImage(imageSource) .setUpscaleFactor(UpscaleFactor.R2000x2000) ); console.log(result.image.url);
نتيجة const = انتظار imageApi.ultraEnhance( new UltraEnhanceRequest().setImage(imageSource).setUpscaleFactor(6),); console.log(result.image.url);
نتيجة const = انتظار imageApi.ultraUpscale( new UltraUpscaleRequest().setImage(imageSource).setUpscaleFactor(4).setMode(ProcessingMode.async),); console.log(result.image.url);
لإنشاء حزمة استخدم الأمر التالي:
بناء تشغيل npm
سيتم إنشاء دليل /lib
في الدليل الجذر للمشروع والذي سيحتوي على حزمة npm جاهزة للنشر.
قم بتشغيل الأمر التالي لإضافة إشعار الترخيص المعياري في جميع ملفات *.ts:
رخصة تشغيل npm
لن يقوم هذا الأمر بإضافة الرأس إلى كافة الملفات الجديدة فحسب، بل سيصلح أيضًا الملفات الموجودة إذا كانت هناك حاجة.
لتتمكن من تشغيل هذا على نظام التشغيل macOS، تحتاج إلى تثبيت GNU sed. إذا لم تقم بتثبيته بعد، فاتبع الخطوات التالية:
تثبيت Homebrew : إذا لم يكن Homebrew مثبتًا لديك، فافتح Terminal وقم بتشغيل:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
تثبيت GNU sed : بمجرد تثبيت Homebrew، قم بتشغيل الأمر التالي لتثبيت GNU sed:
الشراب تثبيت gnu-sed
يتم إنشاء مراجع واجهة برمجة التطبيقات باستخدام TypeDoc استنادًا إلى تعليقات TSDoc في التعليمات البرمجية. قم بتشغيل الأمر التالي لإنشائه:
تشغيل npm لتوليد المستندات
سيقوم هذا الأمر بإنشاء وثائق API بتنسيق HTML في دليل /docs
.
لإجراء الاختبارات، استخدم الأمر التالي:
اختبار npm
يتم توفير Picsart Creative APIs SDK بموجب ترخيص MIT الذي يمكن العثور عليه في ملف الترخيص. باستخدام هذا المشروع أو توزيعه أو المساهمة فيه، فإنك توافق على شروط وأحكام هذا الترخيص.
يحتوي هذا المشروع على بعض تبعيات الطرف الثالث، والتي قد يكون لكل منها ترخيص مستقل:
axios:^1.7.2, (MIT): يُستخدم كعميل http
axios-retry:^4.3.0, (Apache License V2.0): يستخدم كملحق لـ axios للتعامل مع إعادة المحاولة
بيانات النموذج: ^ 4.0.0، (MIT): تُستخدم لإنشاء حمولات بيانات متعددة الأجزاء/النماذج
نعم: ^1.4.0، (MIT): يستخدم للتحقق من صحة الطلب من جانب العميل
إذا كنت تحب Picsart Creative APIs SDK وترغب في المساهمة في هذا المشروع مفتوح المصدر، يرجى مراجعة دليل المساهمة.