CodeGeeX4 عائلة نماذج برمجة متعددة اللغات تتمحور حول المساعدة البرمجية والعمل عبر ملفات مصدرية مترابطة. تنشر الشركة CodeGeeX4-ALL-9B عضوًا مفتوح المصدر في السلسلة، طُوّر بالتدريب المستمر على GLM-4-9B. تغطي وثائقه توليد الشيفرة وإكمالها والأسئلة البرمجية وتحليل المستودعات ومسارات متصلة تتضمن مفسّر شيفرة أو بحثًا في الويب أو استدعاءات دوال. الناتج المعتاد نص: شيفرة أو شروح أو إجابات أو تغييرات تحمل تسميات الملفات، وفق تعليمة المهمة.
ابدأ باختيار العملية وتزويد النموذج بالشيفرة اللازمة. يتضمن دليل موجّهات النظام الأصلي تعليمات منفصلة لإضافة التعليقات وشرح برنامج والترجمة بين لغات البرمجة ومراجعة الشيفرة أو إصلاحها وتوليد الاختبارات والإجابة عن أسئلة حول ملف. للإصلاح، أدرج الشيفرة التي تفشل والسلوك الملحوظ والنتيجة المقصودة. للترجمة، حدّد لغة البرمجة المستهدفة وقدّم الدالة المعنية كاملة. في التعليقات، تحافظ تعليمة المهمة لدى الشركة على الشيفرة وتضيف تعليقات؛ وفي عدة مهام لإنتاج الشيفرة، تطلب الشيفرة وحدها. تجعل هذه الفروق الناتج صالحًا كمخرج برمجي أو شرح، بدل ترك تنسيق المخرجات ضمنيًا.
توفّر الأدلة موجّهات نظام بالصينية والإنجليزية. لا تحدّد لغة تعليمة النظام وحدها لغة الإجابة، لذا اطلب لغة الرد صراحةً حين تحتاج إلى شرح. تصف إرشادات المراجعة المتخصصة مخرجات صينية؛ ويقدّم موجّه المساعد البرمجي العام طريقة منفصلة لطلب مراجعة بلغة رد أخرى. تضبط بعض قوالب المهام لغة التعليقات لتطابق المصدر، وتستبعد المخرجات التي تمزج الصينية والإنجليزية. في محادثة مستمرة، كرّر تعليمة المهمة المناسبة عند تبديل العمليات، حتى لا يختلط طلب شرح بالطلب السابق لمخرجات شيفرة فقط.
في الإكمال السياقي، يصف التنسيق الأصلي الملف الهدف ولغة برمجته والشيفرة على جانبي نقطة الإدراج. استخدم المسار النسبي للملف مع ###PATH: وأدرج ###LANGUAGE:؛ ويسمح الدليل بقيمة لغة فارغة عندما تكون مجهولة. يختار ###MODE: القيمة LINE لإكمال سطر واحد أو BLOCK لعدة أسطر، وBLOCK هو الافتراضي الموثّق. يأتي تسلسل ملء الوسط باللاحقة أولًا، ثم السابقة، ثم الوسط المفقود، بعلامات <|code_suffix|> و<|code_prefix|> و<|code_middle|>. يحذف قالب الملء لدى الشركة موجّه النظام. يمنح الاحتفاظ باللاحقة النموذج تدفق التحكم المحيط والشيفرة التي يجب أن تبقى بعد الإدراج. الناتج شيفرة مفقودة مقترحة، يمكن فحصها بعد ذلك في موضعها الأصلي.
يضيف الإكمال عبر الملفات مقتطفات مرتبطة كمادة مرجعية، يبدأ كل منها بـ###REFERENCE: ومسار ###PATH: خاص به. أبقِ هذه المراجع منفصلة عن الملف الهدف ونقطة إدراجه. على سبيل المثال، عند إكمال دالة تستدعي دالة مساعدة موجودة، قدّم توقيع الدالة المساعدة وتنفيذها مع سابقة الدالة الهدف ولاحقتها. يوسّع دليل الإكمال على مستوى المشروع هذا النهج لتوليد ملف جديد من متطلبات المشروع والشيفرة الحالية ذات الصلة. تتيح المسارات الواضحة والتبعيات المختارة التمييز بين الشيفرة المقدّمة دليلًا والملف المطلوب إكماله.
تستخدم أسئلة المستودعات تخطيطًا أصليًا مختلفًا: اسرد كل ملف تحت ###PATH: وأدرج شيفرته ثم اطرح السؤال. يمكن لتكليف مفيد أن يسأل أين تُعرّف قيمة أو كيف يمر استدعاء بين الوحدات المقدّمة. يستخدم تحرير المستودع تعليمة نظام خاصة لإضافة الملفات أو حذفها أو تعديلها، ويطلب الإخراج بصيغة ###PATH: {PATH} متبوعًا بالشيفرة. جهّز الملفات المعنية وصِف التغيير المطلوب، بما يشمل الملف المراد إضافته أو السلوك المطلوب الحفاظ عليه. اقرأ الكتل المرتجعة ذات تسميات المسارات كتغييرات مقترحة؛ فهي لا تثبت أن مستودعًا عُدّل بالفعل أو أن الشيفرة شُغّلت.
للعضو المنشور CodeGeeX4-ALL-9B، توثّق الشركة سياق 128K وتوصي باختيار محتوى المستودع ذي الصلة عندما يتجاوز المشروع تلك النافذة. يُعد استرجاع المقتطفات المرتبطة وتقليم المدخلات المفرطة خطوات إعداد في دليل المستودعات. يجب أن يتسع السياق للتعليمات والشيفرة المقدّمة والتكملة المولّدة، لذا تكون مجموعة ملفات مستهدفة غالبًا أنفع من تفريغ مشروع بلا تمييز. تتحكم إعدادات التوليد في مثال الشركة في طول تشغيل بعينه؛ ولا تعرّف حدًا أقصى عامًا لطول الإجابة في كل إصدار من CodeGeeX4.
تصف السلسلة أيضًا مسارات برمجية متصلة بالمفسّرات والبحث واستدعاءات الدوال. يحتاج هذا المسار إلى أن يوفّر التطبيق المحيط الأدوات المسماة ويُرجع نتائجها إلى المحادثة. عند طلب شيفرة قابلة للتشغيل، حدّد اللغة المقصودة والتبعيات والسلوك المتوقع؛ وعند طلب تحليل، اطلب مراجع الملفات أو الدوال المعنية. جمّع التغييرات المقترحة أو شغّلها في البيئة المقصودة، وتحقّق من السلوك وفق المتطلب المقدّم قبل إدراجها في المشروع.
", "aboutText": "CodeGeeX4 عائلة نماذج برمجة متعددة اللغات تتمحور حول المساعدة البرمجية والعمل عبر ملفات مصدرية مترابطة. تنشر الشركة CodeGeeX4-ALL-9B عضوًا مفتوح المصدر في السلسلة، طُوّر بالتدريب المستمر على GLM-4-9B. تغطي وثائقه توليد الشيفرة وإكمالها والأسئلة البرمجية وتحليل المستودعات ومسارات متصلة تتضمن مفسّر شيفرة أو بحثًا في الويب أو استدعاءات دوال. الناتج المعتاد نص: شيفرة أو شروح أو إجابات أو تغييرات تحمل تسميات الملفات، وفق تعليمة المهمة.\n\nابدأ باختيار العملية وتزويد النموذج بالشيفرة اللازمة. يتضمن دليل موجّهات النظام الأصلي تعليمات منفصلة لإضافة التعليقات وشرح برنامج والترجمة بين لغات البرمجة ومراجعة الشيفرة أو إصلاحها وتوليد الاختبارات والإجابة عن أسئلة حول ملف. للإصلاح، أدرج الشيفرة التي تفشل والسلوك الملحوظ والنتيجة المقصودة. للترجمة، حدّد لغة البرمجة المستهدفة وقدّم الدالة المعنية كاملة. في التعليقات، تحافظ تعليمة المهمة لدى الشركة على الشيفرة وتضيف تعليقات؛ وفي عدة مهام لإنتاج الشيفرة، تطلب الشيفرة وحدها. تجعل هذه الفروق الناتج صالحًا كمخرج برمجي أو شرح، بدل ترك تنسيق المخرجات ضمنيًا.\n\nتوفّر الأدلة موجّهات نظام بالصينية والإنجليزية. لا تحدّد لغة تعليمة النظام وحدها لغة الإجابة، لذا اطلب لغة الرد صراحةً حين تحتاج إلى شرح. تصف إرشادات المراجعة المتخصصة مخرجات صينية؛ ويقدّم موجّه المساعد البرمجي العام طريقة منفصلة لطلب مراجعة بلغة رد أخرى. تضبط بعض قوالب المهام لغة التعليقات لتطابق المصدر، وتستبعد المخرجات التي تمزج الصينية والإنجليزية. في محادثة مستمرة، كرّر تعليمة المهمة المناسبة عند تبديل العمليات، حتى لا يختلط طلب شرح بالطلب السابق لمخرجات شيفرة فقط.\n\nفي الإكمال السياقي، يصف التنسيق الأصلي الملف الهدف ولغة برمجته والشيفرة على جانبي نقطة الإدراج. استخدم المسار النسبي للملف مع ###PATH: وأدرج ###LANGUAGE:؛ ويسمح الدليل بقيمة لغة فارغة عندما تكون مجهولة. يختار ###MODE: القيمة LINE لإكمال سطر واحد أو BLOCK لعدة أسطر، وBLOCK هو الافتراضي الموثّق. يأتي تسلسل ملء الوسط باللاحقة أولًا، ثم السابقة، ثم الوسط المفقود، بعلامات <|code_suffix|> و<|code_prefix|> و<|code_middle|>. يحذف قالب الملء لدى الشركة موجّه النظام. يمنح الاحتفاظ باللاحقة النموذج تدفق التحكم المحيط والشيفرة التي يجب أن تبقى بعد الإدراج. الناتج شيفرة مفقودة مقترحة، يمكن فحصها بعد ذلك في موضعها الأصلي.\n\nيضيف الإكمال عبر الملفات مقتطفات مرتبطة كمادة مرجعية، يبدأ كل منها بـ###REFERENCE: ومسار ###PATH: خاص به. أبقِ هذه المراجع منفصلة عن الملف الهدف ونقطة إدراجه. على سبيل المثال، عند إكمال دالة تستدعي دالة مساعدة موجودة، قدّم توقيع الدالة المساعدة وتنفيذها مع سابقة الدالة الهدف ولاحقتها. يوسّع دليل الإكمال على مستوى المشروع هذا النهج لتوليد ملف جديد من متطلبات المشروع والشيفرة الحالية ذات الصلة. تتيح المسارات الواضحة والتبعيات المختارة التمييز بين الشيفرة المقدّمة دليلًا والملف المطلوب إكماله.\n\nتستخدم أسئلة المستودعات تخطيطًا أصليًا مختلفًا: اسرد كل ملف تحت ###PATH: وأدرج شيفرته ثم اطرح السؤال. يمكن لتكليف مفيد أن يسأل أين تُعرّف قيمة أو كيف يمر استدعاء بين الوحدات المقدّمة. يستخدم تحرير المستودع تعليمة نظام خاصة لإضافة الملفات أو حذفها أو تعديلها، ويطلب الإخراج بصيغة ###PATH: {PATH} متبوعًا بالشيفرة. جهّز الملفات المعنية وصِف التغيير المطلوب، بما يشمل الملف المراد إضافته أو السلوك المطلوب الحفاظ عليه. اقرأ الكتل المرتجعة ذات تسميات المسارات كتغييرات مقترحة؛ فهي لا تثبت أن مستودعًا عُدّل بالفعل أو أن الشيفرة شُغّلت.\n\nللعضو المنشور CodeGeeX4-ALL-9B، توثّق الشركة سياق 128K وتوصي باختيار محتوى المستودع ذي الصلة عندما يتجاوز المشروع تلك النافذة. يُعد استرجاع المقتطفات المرتبطة وتقليم المدخلات المفرطة خطوات إعداد في دليل المستودعات. يجب أن يتسع السياق للتعليمات والشيفرة المقدّمة والتكملة المولّدة، لذا تكون مجموعة ملفات مستهدفة غالبًا أنفع من تفريغ مشروع بلا تمييز. تتحكم إعدادات التوليد في مثال الشركة في طول تشغيل بعينه؛ ولا تعرّف حدًا أقصى عامًا لطول الإجابة في كل إصدار من CodeGeeX4.\n\nتصف السلسلة أيضًا مسارات برمجية متصلة بالمفسّرات والبحث واستدعاءات الدوال. يحتاج هذا المسار إلى أن يوفّر التطبيق المحيط الأدوات المسماة ويُرجع نتائجها إلى المحادثة. عند طلب شيفرة قابلة للتشغيل، حدّد اللغة المقصودة والتبعيات والسلوك المتوقع؛ وعند طلب تحليل، اطلب مراجع الملفات أو الدوال المعنية. جمّع التغييرات المقترحة أو شغّلها في البيئة المقصودة، وتحقّق من السلوك وفق المتطلب المقدّم قبل إدراجها في المشروع.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "bf84702e22d9e221107119adcb832c3af4af625dab794b377549064309eec2df", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "codegeex-4CodeGeeX4 عائلة نماذج برمجة متعددة اللغات لتوليد الشيفرة وإكمالها وشرحها وإصلاحها وأسئلة المستودعات. تغطي أدلتها الأصلية موجّهات خاصة بالمهام وملء الفجوات بين الشيفرات الموجودة واستخدام الملفات المرتبطة لإعداد تغييرات بمسارات ملفات صريحة.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
CodeGeeX4 عائلة نماذج برمجة متعددة اللغات تتمحور حول المساعدة البرمجية والعمل عبر ملفات مصدرية مترابطة. تنشر الشركة CodeGeeX4-ALL-9B عضوًا مفتوح المصدر في السلسلة، طُوّر بالتدريب المستمر على GLM-4-9B. تغطي وثائقه توليد الشيفرة وإكمالها والأسئلة البرمجية وتحليل المستودعات ومسارات متصلة تتضمن مفسّر شيفرة أو بحثًا في الويب أو استدعاءات دوال. الناتج المعتاد نص: شيفرة أو شروح أو إجابات أو تغييرات تحمل تسميات الملفات، وفق تعليمة المهمة.
ابدأ باختيار العملية وتزويد النموذج بالشيفرة اللازمة. يتضمن دليل موجّهات النظام الأصلي تعليمات منفصلة لإضافة التعليقات وشرح برنامج والترجمة بين لغات البرمجة ومراجعة الشيفرة أو إصلاحها وتوليد الاختبارات والإجابة عن أسئلة حول ملف. للإصلاح، أدرج الشيفرة التي تفشل والسلوك الملحوظ والنتيجة المقصودة. للترجمة، حدّد لغة البرمجة المستهدفة وقدّم الدالة المعنية كاملة. في التعليقات، تحافظ تعليمة المهمة لدى الشركة على الشيفرة وتضيف تعليقات؛ وفي عدة مهام لإنتاج الشيفرة، تطلب الشيفرة وحدها. تجعل هذه الفروق الناتج صالحًا كمخرج برمجي أو شرح، بدل ترك تنسيق المخرجات ضمنيًا.
توفّر الأدلة موجّهات نظام بالصينية والإنجليزية. لا تحدّد لغة تعليمة النظام وحدها لغة الإجابة، لذا اطلب لغة الرد صراحةً حين تحتاج إلى شرح. تصف إرشادات المراجعة المتخصصة مخرجات صينية؛ ويقدّم موجّه المساعد البرمجي العام طريقة منفصلة لطلب مراجعة بلغة رد أخرى. تضبط بعض قوالب المهام لغة التعليقات لتطابق المصدر، وتستبعد المخرجات التي تمزج الصينية والإنجليزية. في محادثة مستمرة، كرّر تعليمة المهمة المناسبة عند تبديل العمليات، حتى لا يختلط طلب شرح بالطلب السابق لمخرجات شيفرة فقط.
في الإكمال السياقي، يصف التنسيق الأصلي الملف الهدف ولغة برمجته والشيفرة على جانبي نقطة الإدراج. استخدم المسار النسبي للملف مع ###PATH: وأدرج ###LANGUAGE:؛ ويسمح الدليل بقيمة لغة فارغة عندما تكون مجهولة. يختار ###MODE: القيمة LINE لإكمال سطر واحد أو BLOCK لعدة أسطر، وBLOCK هو الافتراضي الموثّق. يأتي تسلسل ملء الوسط باللاحقة أولًا، ثم السابقة، ثم الوسط المفقود، بعلامات <|code_suffix|> و<|code_prefix|> و<|code_middle|>. يحذف قالب الملء لدى الشركة موجّه النظام. يمنح الاحتفاظ باللاحقة النموذج تدفق التحكم المحيط والشيفرة التي يجب أن تبقى بعد الإدراج. الناتج شيفرة مفقودة مقترحة، يمكن فحصها بعد ذلك في موضعها الأصلي.
يضيف الإكمال عبر الملفات مقتطفات مرتبطة كمادة مرجعية، يبدأ كل منها بـ###REFERENCE: ومسار ###PATH: خاص به. أبقِ هذه المراجع منفصلة عن الملف الهدف ونقطة إدراجه. على سبيل المثال، عند إكمال دالة تستدعي دالة مساعدة موجودة، قدّم توقيع الدالة المساعدة وتنفيذها مع سابقة الدالة الهدف ولاحقتها. يوسّع دليل الإكمال على مستوى المشروع هذا النهج لتوليد ملف جديد من متطلبات المشروع والشيفرة الحالية ذات الصلة. تتيح المسارات الواضحة والتبعيات المختارة التمييز بين الشيفرة المقدّمة دليلًا والملف المطلوب إكماله.
تستخدم أسئلة المستودعات تخطيطًا أصليًا مختلفًا: اسرد كل ملف تحت ###PATH: وأدرج شيفرته ثم اطرح السؤال. يمكن لتكليف مفيد أن يسأل أين تُعرّف قيمة أو كيف يمر استدعاء بين الوحدات المقدّمة. يستخدم تحرير المستودع تعليمة نظام خاصة لإضافة الملفات أو حذفها أو تعديلها، ويطلب الإخراج بصيغة ###PATH: {PATH} متبوعًا بالشيفرة. جهّز الملفات المعنية وصِف التغيير المطلوب، بما يشمل الملف المراد إضافته أو السلوك المطلوب الحفاظ عليه. اقرأ الكتل المرتجعة ذات تسميات المسارات كتغييرات مقترحة؛ فهي لا تثبت أن مستودعًا عُدّل بالفعل أو أن الشيفرة شُغّلت.
للعضو المنشور CodeGeeX4-ALL-9B، توثّق الشركة سياق 128K وتوصي باختيار محتوى المستودع ذي الصلة عندما يتجاوز المشروع تلك النافذة. يُعد استرجاع المقتطفات المرتبطة وتقليم المدخلات المفرطة خطوات إعداد في دليل المستودعات. يجب أن يتسع السياق للتعليمات والشيفرة المقدّمة والتكملة المولّدة، لذا تكون مجموعة ملفات مستهدفة غالبًا أنفع من تفريغ مشروع بلا تمييز. تتحكم إعدادات التوليد في مثال الشركة في طول تشغيل بعينه؛ ولا تعرّف حدًا أقصى عامًا لطول الإجابة في كل إصدار من CodeGeeX4.
تصف السلسلة أيضًا مسارات برمجية متصلة بالمفسّرات والبحث واستدعاءات الدوال. يحتاج هذا المسار إلى أن يوفّر التطبيق المحيط الأدوات المسماة ويُرجع نتائجها إلى المحادثة. عند طلب شيفرة قابلة للتشغيل، حدّد اللغة المقصودة والتبعيات والسلوك المتوقع؛ وعند طلب تحليل، اطلب مراجع الملفات أو الدوال المعنية. جمّع التغييرات المقترحة أو شغّلها في البيئة المقصودة، وتحقّق من السلوك وفق المتطلب المقدّم قبل إدراجها في المشروع.
POST /v1/chat/completionstexttext| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود codegeex-4 | القيمة الافتراضية— |
الحقلmessages | النوعmessage[] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 | القيمة الافتراضية— |
الحقلmessages[].role | النوعstring | المتطلبمطلوب | القيم والحدود يعتمد على النموذج | القيمة الافتراضية— |
الحقلmessages[].content | النوعstring | المتطلباختياري | القيم والحدود ينطبق عندما: محادثة نصية | القيمة الافتراضية— |
الحقلstream | النوعboolean | المتطلباختياري | القيم والحدود | القيمة الافتراضيةfalse |
النص · نص UTF8
messages[].content
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, messages |
المعلمةmaterial_types | المواصفاتtext |
المعلمةmessages | المواصفاتمصفوفة رسائل ببنية role/content |
المعلمةfile_material | المواصفاتمستند UTF-8 الفعلي مُدرج كنص حرفي؛ لا يُستنتَج معرّف ملف |
المعلمةoptional_controls | المواصفاتstream |
المعلمةcontrol_scope | المواصفاتمحادثة نصية؛ stream قيمة منطقية، وقيمتها الافتراضية false. |
المعلمةoutput_modalities | المواصفاتtext |
المعلمةhosted_operations | المواصفاتfalse |
المعلمةmultimodal_input_binding | المواصفاتnull |
الأسماء البديلة للطريقة: /chat/completions
دورة الحياة: synchronous_or_streamed
أرسل معرّف النموذج الدقيق مع messages.
طول السياق ليس حدًا أقصى للإخراج.
يمكن لملف نصي تقديم نص حرفي؛ وتحتاج مدخلات الصور/الصوت/كائنات الملفات إلى ربط دقيق.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.028 / 1K من الرموز الإخراج · رموز الإخراج $0.028 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت $0 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت $0 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"codegeex-4","messages":[{"role":"user","content":"hello"}],"stream":false}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model="codegeex-4", messages=[{"role":"user","content":"hello"}], stream=False)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\njson أو SSE
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بكل اختيار ومحتواه واستدعاءات أدواته واستدلاله. في SSE، جمّع التحديثات بحسب فهرس الاختيار/الأداة، واحتفظ بسبب الإنهاء النهائي والاستخدام.
احتفظ بمعرّفات الطلبات/الاستجابات والترويسات. لا يُقدَّم URL عام لاسترجاع مهمة نصية.
| الحقل | النوع |
|---|---|
الحقلchoices[].index | النوعinteger |
الحقلchoices[].message.content | النوعstring|null |
الحقلchoices[].message.tool_calls | النوعtool_call[] |
الحقلchoices[].message.reasoning_content | النوعstring |
الحقلchoices[].message.reasoning_details | النوعobject|array |
الحقلchoices[].finish_reason | النوعstring|null |
الحقلusage | النوعobject |
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
Ailoot Ultra codegeex-4
/chat/completions
codegeex-4CodeGeeX4 عائلة نماذج برمجة متعددة اللغات لتوليد الشيفرة وإكمالها وشرحها وإصلاحها وأسئلة المستودعات. تغطي أدلتها الأصلية موجّهات خاصة بالمهام وملء الفجوات بين الشيفرات الموجودة واستخدام الملفات المرتبطة لإعداد تغييرات بمسارات ملفات صريحة.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
CodeGeeX4 عائلة نماذج برمجة متعددة اللغات تتمحور حول المساعدة البرمجية والعمل عبر ملفات مصدرية مترابطة. تنشر الشركة CodeGeeX4-ALL-9B عضوًا مفتوح المصدر في السلسلة، طُوّر بالتدريب المستمر على GLM-4-9B. تغطي وثائقه توليد الشيفرة وإكمالها والأسئلة البرمجية وتحليل المستودعات ومسارات متصلة تتضمن مفسّر شيفرة أو بحثًا في الويب أو استدعاءات دوال. الناتج المعتاد نص: شيفرة أو شروح أو إجابات أو تغييرات تحمل تسميات الملفات، وفق تعليمة المهمة.
ابدأ باختيار العملية وتزويد النموذج بالشيفرة اللازمة. يتضمن دليل موجّهات النظام الأصلي تعليمات منفصلة لإضافة التعليقات وشرح برنامج والترجمة بين لغات البرمجة ومراجعة الشيفرة أو إصلاحها وتوليد الاختبارات والإجابة عن أسئلة حول ملف. للإصلاح، أدرج الشيفرة التي تفشل والسلوك الملحوظ والنتيجة المقصودة. للترجمة، حدّد لغة البرمجة المستهدفة وقدّم الدالة المعنية كاملة. في التعليقات، تحافظ تعليمة المهمة لدى الشركة على الشيفرة وتضيف تعليقات؛ وفي عدة مهام لإنتاج الشيفرة، تطلب الشيفرة وحدها. تجعل هذه الفروق الناتج صالحًا كمخرج برمجي أو شرح، بدل ترك تنسيق المخرجات ضمنيًا.
توفّر الأدلة موجّهات نظام بالصينية والإنجليزية. لا تحدّد لغة تعليمة النظام وحدها لغة الإجابة، لذا اطلب لغة الرد صراحةً حين تحتاج إلى شرح. تصف إرشادات المراجعة المتخصصة مخرجات صينية؛ ويقدّم موجّه المساعد البرمجي العام طريقة منفصلة لطلب مراجعة بلغة رد أخرى. تضبط بعض قوالب المهام لغة التعليقات لتطابق المصدر، وتستبعد المخرجات التي تمزج الصينية والإنجليزية. في محادثة مستمرة، كرّر تعليمة المهمة المناسبة عند تبديل العمليات، حتى لا يختلط طلب شرح بالطلب السابق لمخرجات شيفرة فقط.
في الإكمال السياقي، يصف التنسيق الأصلي الملف الهدف ولغة برمجته والشيفرة على جانبي نقطة الإدراج. استخدم المسار النسبي للملف مع ###PATH: وأدرج ###LANGUAGE:؛ ويسمح الدليل بقيمة لغة فارغة عندما تكون مجهولة. يختار ###MODE: القيمة LINE لإكمال سطر واحد أو BLOCK لعدة أسطر، وBLOCK هو الافتراضي الموثّق. يأتي تسلسل ملء الوسط باللاحقة أولًا، ثم السابقة، ثم الوسط المفقود، بعلامات <|code_suffix|> و<|code_prefix|> و<|code_middle|>. يحذف قالب الملء لدى الشركة موجّه النظام. يمنح الاحتفاظ باللاحقة النموذج تدفق التحكم المحيط والشيفرة التي يجب أن تبقى بعد الإدراج. الناتج شيفرة مفقودة مقترحة، يمكن فحصها بعد ذلك في موضعها الأصلي.
يضيف الإكمال عبر الملفات مقتطفات مرتبطة كمادة مرجعية، يبدأ كل منها بـ###REFERENCE: ومسار ###PATH: خاص به. أبقِ هذه المراجع منفصلة عن الملف الهدف ونقطة إدراجه. على سبيل المثال، عند إكمال دالة تستدعي دالة مساعدة موجودة، قدّم توقيع الدالة المساعدة وتنفيذها مع سابقة الدالة الهدف ولاحقتها. يوسّع دليل الإكمال على مستوى المشروع هذا النهج لتوليد ملف جديد من متطلبات المشروع والشيفرة الحالية ذات الصلة. تتيح المسارات الواضحة والتبعيات المختارة التمييز بين الشيفرة المقدّمة دليلًا والملف المطلوب إكماله.
تستخدم أسئلة المستودعات تخطيطًا أصليًا مختلفًا: اسرد كل ملف تحت ###PATH: وأدرج شيفرته ثم اطرح السؤال. يمكن لتكليف مفيد أن يسأل أين تُعرّف قيمة أو كيف يمر استدعاء بين الوحدات المقدّمة. يستخدم تحرير المستودع تعليمة نظام خاصة لإضافة الملفات أو حذفها أو تعديلها، ويطلب الإخراج بصيغة ###PATH: {PATH} متبوعًا بالشيفرة. جهّز الملفات المعنية وصِف التغيير المطلوب، بما يشمل الملف المراد إضافته أو السلوك المطلوب الحفاظ عليه. اقرأ الكتل المرتجعة ذات تسميات المسارات كتغييرات مقترحة؛ فهي لا تثبت أن مستودعًا عُدّل بالفعل أو أن الشيفرة شُغّلت.
للعضو المنشور CodeGeeX4-ALL-9B، توثّق الشركة سياق 128K وتوصي باختيار محتوى المستودع ذي الصلة عندما يتجاوز المشروع تلك النافذة. يُعد استرجاع المقتطفات المرتبطة وتقليم المدخلات المفرطة خطوات إعداد في دليل المستودعات. يجب أن يتسع السياق للتعليمات والشيفرة المقدّمة والتكملة المولّدة، لذا تكون مجموعة ملفات مستهدفة غالبًا أنفع من تفريغ مشروع بلا تمييز. تتحكم إعدادات التوليد في مثال الشركة في طول تشغيل بعينه؛ ولا تعرّف حدًا أقصى عامًا لطول الإجابة في كل إصدار من CodeGeeX4.
تصف السلسلة أيضًا مسارات برمجية متصلة بالمفسّرات والبحث واستدعاءات الدوال. يحتاج هذا المسار إلى أن يوفّر التطبيق المحيط الأدوات المسماة ويُرجع نتائجها إلى المحادثة. عند طلب شيفرة قابلة للتشغيل، حدّد اللغة المقصودة والتبعيات والسلوك المتوقع؛ وعند طلب تحليل، اطلب مراجع الملفات أو الدوال المعنية. جمّع التغييرات المقترحة أو شغّلها في البيئة المقصودة، وتحقّق من السلوك وفق المتطلب المقدّم قبل إدراجها في المشروع.
POST /v1/messagestextjson, sse| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود codegeex-4 | القيمة الافتراضية— |
الحقلmessages | النوعmessage[] | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلmessages[].role | النوعstring | المتطلبمطلوب | القيم والحدود user, assistant | القيمة الافتراضية— |
الحقلmessages[].content | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلmax_tokens | النوعinteger | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلstream | النوعboolean | المتطلباختياري | القيم والحدود | القيمة الافتراضيةfalse |
النص · نص UTF-8
سلسلة نصية messages[].content
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, messages, max_tokens |
المعلمةoptional_controls | المواصفاتstream |
المعلمةmaterial_types | المواصفاتtext |
المعلمةtext_file_material | المواصفاتاقرأ مستند UTF-8 الفعلي وضع نصه في الإدخال المحدد أو السلسلة النصية لمحتوى الرسالة. |
دورة الحياة: synchronous_or_streamed
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.028 / 1K من الرموز الإخراج · رموز الإخراج $0.028 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت $0 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت $0 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
{\n "model": "codegeex-4",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'codegeex-4', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'codegeex-4', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON أو SSE
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بكل كتل المحتوى وتوقيعات التفكير ومعرّفات استخدام الأدوات الفعلية. جمّع جميع تحديثات كتل SSE؛ فأول كتلة نصية ليست الإخراج الكامل.
احتفظ بمعرّفات الطلبات/الاستجابات والترويسات. لا يُقدَّم URL عام لاسترجاع مهمة نصية.
| الحقل | النوع |
|---|---|
الحقلid | النوعstring |
الحقلmodel | النوعstring |
الحقلcontent[] | النوعtext|thinking|tool_use|other content block |
الحقلstop_reason | النوعstring|null |
الحقلusage | النوعobject |
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
Ailoot Ultra codegeex-4
/chat/completions