api.acedata.cloud مثل إكمالات الدردشة، الصور، الفيديو، الموسيقى، البحث، x402 وغيرها في طرق قوية النوع، مما يوفر عليك كتابة HTTP، SSE، استقصاء المهام، معالجة الأخطاء وتأخير إعادة المحاولة.
تم تنظيم هذا الفصل وفقًا لترتيب الاتصال الحقيقي: أولاً احصل على رمز API من وحدة التحكم، ثم اختر اللغة واطلع على الفصل المقابل، وأخيرًا انظر إلى استقصاء المهام، الاستجابة المتدفقة والاستخدامات المتقدمة للدفع على سلسلة X402.
المستودع والحزم
- كود المصدر لـ SDK (monorepo): https://github.com/AceDataCloud/SDK
- TypeScript:
@acedatacloud/sdk - Python:
acedatacloud - Go:
github.com/AceDataCloud/SDK/go - عميل X402 (TypeScript):
@acedatacloud/x402-client - عميل X402 (Python):
acedatacloud-x402
مصفوفة القدرات للغات الثلاث
الموارد المتعددة والمهام في SDK Go حاليًا في مرحلة alpha (الإصدار الوهميv0.0.0-20260505072132-4a3d921f9bb4)، والقدرة المستقرة هيchat.completions. يُفضل اختيار TypeScript أو Python في السيناريوهات متعددة الوسائط.
متى تستخدم SDK / MCP / HTTP الأصلي / X402
لا تتعارض SDK مع X402: تدعم SDK كل من “مسار الرمز” و”مسار
paymentHandler”، انظر SDK + خطاف دفع X402.
طلب رمز API
لاستخدام SDK، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud - قائمة التطبيقات لطلب رمز API:
إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول سيتم العودة تلقائيًا إلى الصفحة الحالية.
عند الطلب لأول مرة، سيكون هناك حد مجاني متاح، يمكنك تجربة مجموعة متنوعة من خدمات الذكاء الاصطناعي التي تقدمها Ace Data Cloud مجانًا.
انسخ الرمز الذي حصلت عليه، وسنعتبره موحدًا كـ {token}.
متغيرات البيئة الموحدة
تقوم SDK للغات الثلاث تلقائيًا بقراءة نفس متغير البيئةACEDATACLOUD_API_TOKEN، يُوصى باستخدام export في shell، مما يسمح لـ SDK بالتقاطه تلقائيًا:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
ملاحظة: في مستودع مشروع AceDataCloud، يُعتبر تقليديًاACEDATACLOUD_API_KEY(في.env/ CI)، لكن هذه الثلاثة SDK نفسها تتعرف فقط علىACEDATACLOUD_API_TOKEN. إذا كان لديك فقطACEDATACLOUD_API_KEYفي بيئتك، يرجى تمريرها صراحة عند الإنشاء.
ثلاث أمثلة للبدء في 30 ثانية
تقوم الفقرات الثلاث التالية بنفس الشيء: استدعاءgpt-4o-mini، مما يجعله يرد فقط بـ ADC_*_OK. كل فقرة مرفقة بـ نتيجة تشغيل حقيقية، يمكنك استخدام رمزك الخاص لإعادة إنتاجها.
TypeScript
حاليًا، تعلن SDK أن الاستجابة هينتيجة تشغيل البرنامج:Record<string, unknown>، وفي وقت التشغيل هي كائن JSON عادي، يمكن الوصول إليه مباشرة حسب الحقول. في مشاريع TS الصارمة، إذا واجهت أخطاء في النوع، يمكنك مؤقتًا استخدامas any، أو الرجوع إلى استقصاء المهام والاستجابة المتدفقة في SDK لإنشاء ملف تغليف مخصص.
Python
Python SDK الحالية تعيدنتيجة تشغيل البرنامج:dict، لذا استخدمres["id"]بدلاً منres.id. هذه النقطة تختلف عنopenai-python، يجب الانتباه عند الترحيل.
Go
استجابة Go SDK موحدة هينتيجة تشغيل البرنامج:map[string]any، ولا توجد بنية قوية، يجب إجراء تأكيد النوع بنفسك. جميع موصلات الموارد هي سلسلة من الطرق:client.OpenAI().Chat().Completions().Create(...).
id، elapsed_ms، و usage من نفس المصدر: عبر PlatformGateway للتحقق → واجهة برمجة التطبيقات المتوافقة مع OpenAI المستهدفة → كتابة سجلات الفوترة. حقل content هو الإخراج الحقيقي للنموذج، واستخدام العلامة الثابتة ADC_*_OK هو لإثبات أن الاستجابة لم يتم تعديلها بواسطة SDK.
ترتيب القراءة الموصى به
- دليل دمج SDK TypeScript —— الكود الذي يمكن تشغيله بعد
npm install. - دليل دمج SDK Python —— ثلاث طرق للاستخدام: متزامن، غير متزامن، وتدفق.
- دليل دمج SDK Go —— أسلوب Go لـ
context.Contextوتدفق القنوات. - استطلاع المهام واستجابة التدفق لـ SDK —— اختلافات وحدة TaskHandle، تفاصيل تنفيذ SSE، إعادة المحاولة.
- SDK + خطاف دفع X402 —— بدون توكن، تسوية على السلسلة حسب الاستدعاء.
كيفية عرض الرصيد المتبقي
يمكنك عرض الرصيد المتبقي الحالي لحسابك من خلال لوحة تحكم Ace Data Cloud - قائمة التطبيقات. يمكنك عرض جميع سجلات الاستخدام وتفاصيل الخصم من خلال لوحة تحكم Ace Data Cloud - تاريخ الاستخدام.لمعرفة المزيد
- 📦 شفرة مصدر SDK monorepo
- 🔌 دليل تكامل X402
- 🛠 دروس خوادم MCP
- 📊 قائمة الخدمات والأسعار

