الانتقال إلى المحتوى الرئيسي
ارفع الملفات المحلية إلى منصة AceDataCloud CDN للحصول على عنوان URL يمكن الوصول إليه علنًا (بنمط https://cdn.acedata.cloud/uploads/<uuid>.png)، ويمكن الرجوع إليه فورًا في معلمات مثل image_url وreference_url لواجهات الأعمال الأخرى (مثل Midjourney وSuno وFlux). حالات الاستخدام المناسبة:
  • رفع الصورة المرجعية إلى CDN للحصول على URL قبل استدعاء Midjourney /midjourney/imagine.
  • تخزين الفيديو الذي تم إنشاؤه في الخطوة السابقة مؤقتًا لاستخدامه كإدخال للخطوة التالية.
  • استضافة المواد التي يرفعها المستخدمون مؤقتًا، لتجنب إنشاء S3 خاص بك.
ℹ️ تنتمي هذه الواجهة إلى واجهة API لإدارة منصة AceDataCloud، وبادئتها الموحدة هي https://platform.acedata.cloud/api/v1/.

نظرة عامة على الواجهة

شرح المصادقة (كيفية الحصول على رمز الحساب)

رأس الطلب:
طريقة الحصول عليه: سجّل الدخول إلى منصة AceDataCloud ← وحدة تحكم Account Token ← انقر زر «إنشاء». راجع إدارة رموز حساب منصة AceDataCloud للتفاصيل.

جسم الطلب (multipart/form-data)

تنشئ المنصة مسار ملف فريدًا بنفسها، وتحتفظ بالامتداد الآمن في اسم الملف المرفوع، على سبيل المثال، يقابل photo.jpg المسار uploads/<uuid>.jpg. يُكتب نوع MIME الذي يوفّره جزء الرفع في البيانات الوصفية للملف؛ وعندما لا يتم توفيره أو يكون application/octet-stream، تستنتج المنصة النوع باستخدام اسم الملف وتعيين MIME القياسي. لا يقوم استنتاج الامتداد وMIME بتحويل محتوى الملف، لذا تأكد من أن اسم الملف يتطابق مع التنسيق الفعلي.

أمثلة الطلبات

cURL

Python

Node.js

مثال الاستجابة (HTTP 200، مقتطف)

ما عليك سوى أخذ حقل file_url واستخدامه في واجهات الأعمال الأخرى — يمكن الوصول إلى عنوان CDN علنًا حاليًا ولا يتطلب مصادقة؛ لا تعتبره ضمانًا للأرشفة الدائمة.

شرح حقول الاستجابة

معالجة الأخطاء

نصائح عملية

  • رفع الصور كصور مرجعية: تقبل image_urls في Midjourney وimage_url في Flux وreference_url في Veo عناوين CDN، ولا تقبل base64. الحصول على URL أولًا عبر هذه الواجهة هو الإجراء المعتاد.
  • لا ترفع بيانات حساسة: يمكن الوصول إلى عنوان URL المُعاد علنًا؛ تخضع مدة الاحتفاظ لسياسة التخزين الحالية للمنصة، وللأرشفة طويلة الأجل استخدم تخزين الكائنات الخاص بك.
  • الرفع بكميات كبيرة: تحكم في التزامن واضبط مهلة زمنية لكل عملية رفع؛ تعتمد الإنتاجية على حجم الملف وبيئة الشبكة.

الواجهات ذات الصلة