AR ▾
احصل على مفتاح API

qwenapis.comالدليل

واجهة برمجة التطبيقات Qwen3-Coder-Next: خيار متوافق مع OpenAI

هذه الخدمة لا تستضيف نموذجًا باسم Qwen3-Coder-Next. تقدم نموذجًا عامًا واحدًا مفتوح الأوزان خلف نقطة نهاية متوافقة مع OpenAI، وتوضح هذه الصفحة متى يناسب ذلك وكيل البرمجة ومتى لا يناسبه.

تم التحديث:

ذراع روبوتي يجمع كتل الحامل في حلقة بجانب مكعب الخادم، مما يمثل حلقة وكيل برمجة

الإجابة المباشرة حول qwen3-coder-next

إذا كتبت qwen3-coder-next api في مربع بحث، فغالبًا تريد نقطة نهاية يمكنك توجيه وكيل برمجة إليها. كن واضحًا بشأن طبيعة هذا الموقع قبل المضي قدمًا: إنه مزود مستقل يمتلك نموذجًا واحدًا مفتوح الأوزان، معرّف النموذج uncensored، ومضبوط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. ليس واجهة برمجة التطبيقات الرسمية لـ Qwen3-Coder-Next أو لأي نموذج من شركة Alibaba، ولا يوجّه الطلبات بين المزودين. إذا كان خطتك تعتمد على ذلك النموذج المحدد، فإن مزوده الرسمي أو المضيف الذي يسرده باسمه هو الخيار الصحيح.

لماذا نكتب هذه الصفحة؟ لأن الكثيرين الذين يبحثون عن نموذج برمجة ينتهي بهم المطاف إلى الحاجة إلى نفس الأساسيات: نقطة نهاية دردشة على طراز OpenAI مع استدعاء الدوال، نافذة سياق كبيرة، حدّ معدل مستقر وتكلفة لكل رمز متوقعة. تمتلك واجهة برمجة التطبيقات هذه هذه الميزات. كما أنها لا ترفض الطلبات التي ترفضها مساعدات أخرى لأسباب تتعلق بالسياسة، مثل كتابة ماسح للشبكات لشبكتك الخاصة، مناقشة آليات الاستغلال لتمارين المختبر، أو توليد بيانات اختبار تحتوي على لغة عامية. كل شيء يبقى ضمن الاستخدام القانوني، وهناك حدّ واحد صارم: لا محتوى جنسي يتضمن القاصرين.

ما يلي هو مقارنة بسيطة ونمط مُختبر لتشغيل دورة عمل الوكيل ضد https://api.qwenapis.com/v1. لا تقدم هذه الصفحة أرقامًا للمعايير، لأن لا توجد أرقام معروفة هنا، ولا يجب أن تثق بنتائج البرمجة لأي شخص فوق مستودعك الخاص.

ما يطلبه وكيل البرمجة من واجهة برمجة التطبيقات

انزع أسماء المنتجات، ويحتاج وكيل البرمجة إلى ستة أشياء من نقطة نهاية النموذج. إليك كيف تجيب هذه الخدمة على كل منها.

الحاجةما توفره واجهة برمجة التطبيقات هذه
استدعاء الدوال لأدوات القراءة والتعديل والتشغيلنعم: tools، tool_choice، البث المتدفق لـ tool_calls، والنتائج بصيغة role: "tool"
إخراج مُهيكل للخطط والاختلافاتوضع JSON عبر response_format
مساحة كبيرة للملفات الكبيرة وسجلات المحادثات الطويلة100,000 رمز (token)، الموجّه بالإضافة إلى الإكمال
البث المتدفق لمحررات الكتابة الحيةSSE مع الاستخدام في النهاية
تشغيل متكرريتم تمرير seed، وtemperature، وtop_p، وstop والعقوبات
وكلاء فرعيون متزامنين8 طلبات متزامنة، 300 في الدقيقة على مفتاح كامل

ما يساويه في الأهمية هو ما غاب. لا توجد تمثيلات متجهة، لذا يحتاج البحث في الشيفرة عبر فهرس متجه إلى مصدر تمثيل منفصل. لا يوجد ضبط دقيق ولا إدخال أو إخراج للصور. قائمة النماذج تحتوي على مدخل واحد. إذا كان إطار عمل الوكيل يسمح لك باختيار نموذج رخيص للخطوات الصغيرة ونموذج أقوى للتخطيط، فستستخدم هنا نفس النموذج لكلا الدورين.

الملخص الصادق هو أن الأساسيات مكتملة، والسؤال المتبقي هو جودة النموذج في مهامك. هذا سؤال قائم على الملاحظة (empirical)، ورصيد التجربة موجود للإجابة عليه.

حلقة عمل وكيل فعّالة

يعطي هذا المثال النموذج أداتين، واحدة لقراءة ملف وأخرى لتشغيل أمر في مجلد معزول (sandbox)، ويدور حتى يتوقف النموذج عن طلب الأدوات. قم بتشغيله في مجلد مؤقت، لأن أداة التنفيذ تنفذ أي مقترح يقدمه النموذج. النقطة هي البنية: ألصق رسالة المساعد، نفذ كل استدعاء، ألصق رسالة tool واحدة لكل استدعاء، كرر.

import json, os, subprocess
from openai import OpenAI

client = OpenAI(base_url="https://api.qwenapis.com/v1", api_key=os.environ["QWENAPIS_KEY"])

TOOLS = [
    {"type": "function", "function": {
        "name": "read_file", "description": "Read a text file from the working directory",
        "parameters": {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}}},
    {"type": "function", "function": {
        "name": "run", "description": "Run a shell command and return its output",
        "parameters": {"type": "object", "properties": {"cmd": {"type": "string"}}, "required": ["cmd"]}}},
]

def call_tool(name, args):
    if name == "read_file":
        return open(args["path"], encoding="utf-8").read()[:20000]
    if name == "run":
        p = subprocess.run(args["cmd"], shell=True, capture_output=True, text=True, timeout=60)
        return (p.stdout + p.stderr)[-8000:]
    return "unknown tool"

messages = [
    {"role": "system", "content": "You fix failing tests. Use the tools, then reply with a short summary."},
    {"role": "user", "content": "Run pytest, find why it fails, and tell me the fix."},
]

for step in range(12):
    r = client.chat.completions.create(model="uncensored", messages=messages, tools=TOOLS, temperature=0.2)
    msg = r.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for tc in msg.tool_calls:
        try:
            out = call_tool(tc.function.name, json.loads(tc.function.arguments))
        except Exception as e:
            out = f"tool error: {e}"
        messages.append({"role": "tool", "tool_call_id": tc.id, "content": out})

ثلاث تفاصيل تحافظ على صحة حلقة مثل هذه. حدّ عدد الخطوات، كما يفعل range(12). اقتطع إخراج الأداة، لأن كل حرف مُعاد يصبح إدخالًا في الاستدعاء التالي. استخدم درجة حرارة منخفضة لعملية التحرير؛ 0.2 نقطة بداية معقولة، ويمكنك رفعها لخطوات العصف الذهني.

تشغيل عدة وكلاء دون ضربة 429

وكيل واحد تسلسلي ونادرًا ما يسبب مشكلة في حدّ. أسطول منها يفعل. عند تجاوز 8 طلبات متزامنة، ترد واجهة برمجة التطبيقات بـ 429 مع الكود concurrency، وعلى أكثر من 300 في الدقيقة ترد بـ 429 مع rate_limited. الحمل الزائد المؤقت يعيد أيضًا 429، مع رأس Retry-After: 5. الطلبات المتدفقة تحتفظ بمكانها حتى ينتهي البث، لذا فإن الإجابة المتدفقة الطويلة تحسب لمدة كاملة.

import asyncio, os
from openai import AsyncOpenAI, RateLimitError

client = AsyncOpenAI(base_url="https://api.qwenapis.com/v1", api_key=os.environ["QWENAPIS_KEY"])
gate = asyncio.Semaphore(8)

async def ask(prompt, tries=4):
    async with gate:
        for attempt in range(tries):
            try:
                r = await client.chat.completions.create(
                    model="uncensored",
                    messages=[{"role": "user", "content": prompt}],
                )
                return r.choices[0].message.content
            except RateLimitError:
                await asyncio.sleep(5 * (attempt + 1))
    return None

async def main():
    jobs = [ask(f"Write a docstring for function number {i}.") for i in range(40)]
    print(len(await asyncio.gather(*jobs)))

asyncio.run(main())

المسمّك (semaphore) يبقيك عند 8 طلبات نشطة، ووظيفة النوم تزيد الفاصل الزمني عندما يفلت 429 على أي حال. لأن الطلبات الفاشلة لا تُحسب، فإن إعادة المحاولة لا تكلف شيئًا إضافيًا. إذا كنت تشغل قريبًا من السقف، اضبط المسمّك على 6 لترك مساحة لجلسة تفاعلية على نفس المفتاح.

تكلفة تشغيل الوكيل

يُسعّر الوكلاء بناءً على مقدار السياق الذي يعيدون إرساله، وليس على مقدار الكود الذي يكتبونه. خذ تشغيلًا لإصلاح خطأ لمدة 12 خطوة. يزداد السياق مع تراكم إخراج الأداة، لذا افترض متوسط 20,000 رمز إدخال و600 رمز إخراج لكل خطوة.

  • المدخلات: 12 × 20,000 = 240,000 رمز × $0.15 / 1M = $0.036
  • المخرجات: 12 × 600 = 7,200 رمز × $0.50 / 1M = $0.0036
  • لكل تشغيل: $0.0396
  • 50 تشغيل يومياً: 50 × $0.0396 = $1.98

معدلات الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج، تُحسب من رصيد مسبق الدفع لا ينتهي. إضافة رصيد بقيمة $20 تغطي حوالي 505 من هذه التشغيلات ($20 / $0.0396). صفحة التسعير تدرج طبقات المكافآت، وعادة واحدة توفر أكثر من أي طبقة: اجعل إخراج الأداة قصيرًا. تقليص ما تعيد تغذيته إلى النصف يقلل الخط المهيمن إلى النصف.

توجيه نموذج عام لأعمال الكود

يمكن للنموذج الذي لا يُباع كنموذج مخصص للكود أن يؤدي أداءً جيداً في الكود إذا كان الموجّه يحدد له وظيفة واضحة. ضع لغة البرمجة، وإصدار إطار العمل، والقيود في رسالة النظام، مثل إصدار Python وقاعدة عدم السماح بإضافة تبعيات جديدة. اطلب تغييراً واحداً في كل مرة. زوّده بمخرجات الاختبار الفاشل حرفياً بدلاً من وصفه، لأن نص الخطأ الدقيق يحمل معلومات أكثر من إعادة الصياغة.

للتعديلات، اطلب توحيد الاختلافات أو الاستبدال الكامل لدالة واحدة، ورفض أي شيء آخر. النص الحر حول الكود صعب التطبيق آلياً. يساعد وضع JSON عندما تريد خطة كبيانات، مثل قائمة الملفات مع سبب كل تغيير. بعد أن يقترح النموذج التصحيح، شغّل الاختبارات بنفسك وأعد النتيجة؛ لا تقبل ادعاء النموذج بأن الاختبارات نجحت.

حافظ على درجة الحرارة منخفضة للتعديلات وارفعها فقط للعصف الذهني. استخدم seed ثابتًا عند مقارنة نسختين من الموجّه، حتى تأتي الفروقات من الموجّه وليس من ضوضاء العينة. ينطبق نفس الانضباط على أي نموذج، وهو ما يحول التشغيل التجريبي إلى مقارنة عادلة مع أي شيء تستخدمه اليوم.

الاختيار بين هذا وبين نموذج مخصص للكود

استخدم نموذج مخصص للكود من مزوّده الخاص عندما يتطلب عملك هذا النموذج المحدد، على سبيل المثال لأنك قست أدائه على كودك، أو لأن معيار الفريق يتطلبه، أو لأنك تعتمد على ميزة لا يوفرها إلا هذا المزوّد. تحقق من أسعارهم وحدودهم الحالية قبل الالتزام.

استخدم هذا الـ API عندما يكون الرفض هو العامل الذي يبطئك، أو عندما تريد نقطة نهاية متوافقة مع OpenAI تعمل مع أطر العمل التي تشغلها بالفعل، أو عندما يناسبك الدفع حسب الاستخدام من رصيد صغير أكثر من الخطة. كما أنه من المنطقي استخدامه كنقطة نهاية ثانية: أرسل التعديلات الروتينية إلى النموذج المعتاد، ووجّه الطلبات التي ترفضها سياسة التصفية إلى هذا الـ API. التبديل يتم عبر تغيير Base URL واسم النموذج، لذا فإن تكلفة التجربة منخفضة.

للتجربة، اقرأ دليل الطلب الأول، أنشئ مفتاحًا مع خطوات المفتاح، واحصل على رصيد التجربة بقيمة $0.50: نقرة واحدة، بدون بطاقة، لكل شخص، صالح لمدة 7 أيام. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 في الدقيقة، وهو ما يكفي لتشغيل الحلقة أعلاه اثني عشر مرة. لا تُستخدم الموجّهات للتدريب، لذا يبقى مستودع الاختبار الخاص بك خارج أي مجموعة تدريب.

أسئلة وأجوبة

هل هذه هي الـ API الرسمية لـ Qwen3-Coder-Next؟

لا. إنه مزود مستقل يمتلك نموذجًا واحدًا مفتوح الأوزان، معرّف النموذج هو uncensored. إنه ليس واجهة برمجة تطبيقات من بائع رسمي، ولا يقدم نموذجًا مدرجًا تحت هذا الاسم.

هل تدعم استدعاء الدوال لوكلاء البرمجة؟

نعم. تمرر الأدوات وtool_choice، وتتلقى tool_calls (حتى عند البث المتدفق)، وتعيد النتائج كرسائل مع role: tool.

ما حجم قاعدة الكود التي تتسع لطلب واحد؟

النافذة تتسع لـ 100,000 رمز للموجّه والإكمال معًا. أرسل فقط الملفات ذات الصلة بالمهمة واقتصر إخراج الأداة لترك مساحة للرد.

هل يمكن تشغيل عدة وكلاء في آن واحد؟

حتى 8 طلبات متزامنة و300 في الدقيقة باستخدام مفتاح كامل. يسمح مفتاح التجربة بـ 2 و60. فوق ذلك، ستحصل على HTTP 429، لذا استخدم السيمافور (semaphore).

هل يدعم التمثيلات (embeddings) للبحث في الأكواد؟

لا. يغطي الـ API إكمال الدردشة وقائمة النماذج فقط، لذا استخدم مصدراً منفصلاً للبحث المتجهي.

مفتاحك على بُعد استمارة واحدة

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.

احصل على مفتاح API