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/.
نظرة عامة على الواجهة
شرح المصادقة (كيفية الحصول على رمز الحساب)
رأس الطلب:جسم الطلب (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 المُعاد علنًا؛ تخضع مدة الاحتفاظ لسياسة التخزين الحالية للمنصة، وللأرشفة طويلة الأجل استخدم تخزين الكائنات الخاص بك.
- الرفع بكميات كبيرة: تحكم في التزامن واضبط مهلة زمنية لكل عملية رفع؛ تعتمد الإنتاجية على حجم الملف وبيئة الشبكة.
الواجهات ذات الصلة
- الحصول على قائمة خدمات منصة AceDataCloud — للعثور على خدمات الأعمال التي تقبل إدخال URL
- إنشاء بيانات اعتماد API لمنصة AceDataCloud — بعد الرفع، تكون الخطوة التالية عادةً إنشاء بيانات اعتماد لاستدعاء واجهات الأعمال

