تستخدم واجهة برمجة تطبيقات Sakana Fugu بإنشاء مفتاح في console.sakana.ai، ونسخ عنوان URL الأساسي المعروض في وحدة التحكم الخاصة بك، وتوجيه عميل OpenAI الحالي الخاص بك إلى نقطة النهاية هذه. لا يلزم ترحيل SDK. يتم شحن Fugu كواجهة برمجة تطبيقات واحدة متوافقة مع OpenAI، لذا فإن مكتبات Python و JavaScript openai نفسها التي تستخدمها بالفعل ستتحدث إليها بمجرد تبديل عنوان URL الأساسي والمفتاح. خلف نقطة النهاية الواحدة هذه، Fugu هو نظام تنسيق متعدد الوكلاء: وفقًا لـ صفحة إصدار Sakana، فإنه يقرر ما إذا كان سيجيب مباشرة أو يجمع فريقًا من النماذج، ولا يرى رمزك هذا القرار أبدًا. إذا قمت بتوصيل بوابات أخرى من قبل، كما هو الحال في دليلنا إلى واجهة برمجة تطبيقات Claude Fable 5، فسيبدو هذا الإعداد مألوفًا.
يرشدك هذا الدليل خلال الحصول على مفتاح، وتكوين العميل بلغتين، واختيار حقل النموذج، والتعامل مع البث، حتى تتمكن من إرسال أول إكمال دردشة لك في غضون دقائق قليلة.
ما هي واجهة برمجة تطبيقات Sakana Fugu في الواقع
Fugu ليس نموذجًا واحدًا بالمعنى المعتاد. تصفه Sakana بأنه نموذج لغوي مدرب متخصص في التفويض، وتواصل الوكلاء، وتجميع العمل. العنوان الرئيسي للإصدار هو "نموذج واحد لقيادتهم جميعًا". عندما ترسل طلبًا، يقرأ موصل مدرب طلبك ويجيب بمفرده أو ينسق ديناميكيًا العديد من نماذج اللغة الكبيرة (LLMs)، بما في ذلك مثيلات متكررة لذاته، ثم يقوم بتجميع النتيجة في إجابة واحدة.
من وجهة نظر التعليمات البرمجية الخاصة بك، لا شيء من ذلك يهم. أنت تستدعي نقطة نهاية واحدة متوافقة مع OpenAI وتحصل على إكمال دردشة عادي. يبقى الرسم البياني للتنسيق على جانب الخادم. لا تقوم أبدًا بتجميع وكلاء، أو التوجيه بين مقدمي الخدمات، أو إدارة فريق. هذه هي الفكرة الأساسية: التعقيد يكمن خلف واجهة برمجة التطبيقات، وليس في عميلك.
هناك نوعان. "Fugu" هو الخيار المتوازن ذو زمن الاستجابة المنخفض المصمم للعمل اليومي، والترميز، ومراجعة التعليمات البرمجية، وروبوتات الدردشة، والخدمات التفاعلية. يستهدف "Fugu Ultra" أقصى جودة للإجابة لأبحاث الذكاء الاصطناعي، واستنساخ الأوراق، وتحليل الأمن السيبراني، والبحث الأدبي أو براءات الاختراع. خلال مرحلة البيتا وعبر الكثير من التغطية الإعلامية المبكرة، كان يطلق على الإصدار الأصغر اسم "Fugu Mini". ابدأ بالأسماء الحالية، Fugu و Fugu Ultra، وتعامل مع "Mini" كعلامة بيتا القديمة.
النسب البحثية حقيقية ومتاحة للجمهور. تدعم ورقتان بحثيتان من ICLR 2026 هذا النهج: Trinity، وهو منسق بأقل من 20 ألف معلمة تم تحسينه من خلال التطور الخالي من المشتقات بأدوار Thinker و Worker و Verifier، و Conductor، وهو نموذج بحجم 7 مليارات معلمة تم تدريبه بالتعلم المعزز والذي يتعلم هيكل الاتصال بين الوكلاء. يستخدمون طرقًا وأحجامًا مختلفة، لذا لا تخلط بينها. لم يتم نشر العدد الدقيق للمعلمات للمنتج الذي تم شحنه.
الخطوة 1: إنشاء مفتاح API لـ Fugu في console.sakana.ai
توجه إلى console.sakana.ai. يتم الوصول من خلال جدار تسجيل الدخول، لذا قم بتسجيل الدخول باستخدام Google أو البريد الإلكتروني قبل الوصول إلى لوحة المعلومات. تم تشغيل الإصدار التجريبي مع ما يقرب من 500 مستخدم بدءًا من أواخر أبريل 2026. قد يتغير ما إذا كان التسجيل الذاتي المتاح بشكل عام مفتوحًا بالكامل أو لا يزال مقيدًا، لذا تحقق من الحالة الحالية عند الوصول إلى الصفحة. تم تداول قيود على التوفر في الاتحاد الأوروبي/المنطقة الاقتصادية الأوروبية أيضًا؛ تحقق من دعم منطقتك قبل البدء في استخدام واجهة برمجة التطبيقات.
بمجرد دخولك، ابحث عن قسم مفاتيح API. قم بإنشاء مفتاح وتخزينه في مكان آمن، مثل متغير بيئة أو مدير أسرار. تعامل معه بالطريقة التي تتعامل بها مع أي مفتاح مزود آخر: لا تقم أبدًا بإدخاله في التحكم بالمصدر، وقم بتدويره إذا تسرب.
أثناء وجودك في وحدة التحكم، ابحث وانسخ عنوان URL الأساسي لحسابك. هذه هي أهم خطوة، وهي التفصيل الوحيد الذي لا يمكنك تخمينه. لم يتم نشر عنوان URL الأساسي لنقطة نهاية Fugu على أي صفحة عامة لـ Sakana حتى وقت كتابة هذا التقرير. انسخ القيمة الدقيقة التي تعرضها لك وحدة التحكم. لا تفترض أنها تتبع نمطًا معينًا من مزود آخر، ولا تلصق مضيفًا رأيته في منشور منتدى. وحدة التحكم هي مصدر الحقيقة.
الخطوة 2: توجيه عميل OpenAI الحالي الخاص بك إلى Fugu
نظرًا لأن Fugu متوافق مع OpenAI، فإنك تحتفظ بـ SDK الحالي الخاص بك. تقوم بتغيير شيئين فقط: base_url و api_key. كل شيء آخر في طلبك يبقى بنفس شكل إكمال دردشة OpenAI القياسي.
في مقتطفات التعليمات البرمجية أدناه، <YOUR_FUGU_BASE_URL_FROM_CONSOLE> هو عنصر نائب. انسخ عنوان URL الأساسي الحقيقي من وحدة التحكم الخاصة بك؛ لا تخمنه. وينطبق الشيء نفسه على سلسلة النموذج، التي سنغطيها في القسم التالي.
بايثون
from openai import OpenAI
client = OpenAI(
api_key="YOUR_FUGU_API_KEY",
base_url="<YOUR_FUGU_BASE_URL_FROM_CONSOLE>", # copy from console.sakana.ai, do not guess
)
response = client.chat.completions.create(
model="fugu", # confirm the exact model string in your console
messages=[
{"role": "system", "content": "You are a helpful engineering assistant."},
{"role": "user", "content": "Refactor this function to remove the nested loop."},
],
)
print(response.choices[0].message.content)
جافا سكريبت
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FUGU_API_KEY,
baseURL: "<YOUR_FUGU_BASE_URL_FROM_CONSOLE>", // copy from console.sakana.ai, do not guess
});
const response = await client.chat.completions.create({
model: "fugu", // confirm the exact model string in your console
messages: [
{ role: "system", content: "You are a helpful engineering assistant." },
{ role: "user", content: "Refactor this function to remove the nested loop." },
],
});
console.log(response.choices[0].message.content);
هذا هو الترحيل بأكمله. إذا قمت بتوجيه عميل OpenAI عبر بوابة خارجية من قبل، فإن النمط مطابق لإعدادات مثل Claude Code مع OpenRouter: نفس العميل، عنوان URL أساسي جديد، مفتاح جديد. يكمن الاختلاف في ما يحدث على جانب الخادم، والذي سنتناوله أدناه.
الخطوة 3: اختيار حقل النموذج
يحدد حقل model المتغير. السلاسل المبلغ عنها هي fugu للنموذج المتوازن و fugu-ultra للنموذج ذي الجودة القصوى. أبلغت بعض المصادر أيضًا عن معرف قديم، شيء على غرار fugu-ultra-20260615. يمكن أن تتغير المعرفات مثل هذه بين الإصدارات، لذا تأكد من السلسلة الدقيقة التي تعرضها وحدة التحكم الخاصة بك بدلاً من نسخ معرف قديم من مقال. هذا هو السبب أيضًا في أن هذا الدليل يبقي المعرفات القديمة خارج العناوين: فهي تصبح قديمة، ووحدة التحكم الخاصة بك هي المرجع الموثوق.
قاعدة عملية: ابدأ بـ fugu لأحمال العمل التفاعلية، والترميز، والدردشة، حيث يكون زمن الاستجابة مهمًا. انتقل إلى fugu-ultra عندما تتفوق جودة الإجابة على السرعة، على سبيل المثال البحث العميق، أو استنساخ الأوراق، أو مراجعة الأمان. يعيش كلا المتغيرين خلف نفس نقطة النهاية، لذا فإن التبديل هو تغيير سطر واحد لقيمة model.
إليك اختيار المتغير في التعليمات البرمجية:
# Balanced, low latency
fast = client.chat.completions.create(
model="fugu",
messages=[{"role": "user", "content": "Summarize this changelog in three bullets."}],
)
# Maximum answer quality
deep = client.chat.completions.create(
model="fugu-ultra", # confirm the exact string in your console
messages=[{"role": "user", "content": "Reproduce the main result of this paper and flag any gaps."}],
)
الخطوة 4: بث الاستجابات
يعمل البث تمامًا كما هو الحال مع OpenAI. اضبط stream=True (أو stream: true) وكرر على الأجزاء. هذا مفيد لواجهات مستخدم الدردشة والإجابات الطويلة حيث تريد ظهور الرموز المميزة فور وصولها.
البث بايثون
stream = client.chat.completions.create(
model="fugu",
messages=[{"role": "user", "content": "Walk me through setting up a CI pipeline."}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)
البث جافا سكريبت
const stream = await client.chat.completions.create({
model: "fugu",
messages: [{ role: "user", content: "Walk me through setting up a CI pipeline." }],
stream: true,
});
for await (const chunk of stream) {
const delta = chunk.choices[0]?.delta?.content;
if (delta) process.stdout.write(delta);
}
شيء واحد يجب فهمه حول البث مع Fugu: حتى عندما يتم بث الاستجابة رمزًا تلو الآخر، فإن التنسيق لا يزال يحدث على جانب الخادم أولاً. إذا قام الموصل بتجميع فريق لطلبك، فإن هذا التنسيق تم حله قبل أو أثناء الإنشاء، ويحمل تدفقك فقط الإخراج المُركّب. لن ترى محادثة وكيل وسيطة أو رسم بياني للتوجيه في التدفق. تحصل على نص نظيف، تمامًا مثل واجهة برمجة تطبيقات نموذج واحد.
ماذا يحدث خلف طلب واحد
هذا هو الجزء الذي يجعل Fugu مختلفًا عن واجهة برمجة تطبيقات النموذج العادي، وهو يستحق الفهم على الرغم من أن التعليمات البرمجية الخاصة بك تظل بسيطة. عندما يصل طلبك، يقرأه الموصل ويتخذ قرارًا: الإجابة مباشرة، أو بناء فريق. إذا قام ببناء فريق، فيمكنه سحب العديد من نماذج اللغة الكبيرة (LLMs)، بما في ذلك المزيد من مثيلات Fugu بشكل متكرر، ثم دمج عملها في رد واحد.
تستحق بعض الآليات من صفحة الإصدار معرفتها إذا كانت لديك متطلبات حوكمة. يمكن تبديل الوكلاء في المجموعة. يمكن للفرق اختيار وكلاء معينين، مما يساعد عندما تعني قاعدة بيانات أو امتثال أن مزودًا معينًا لا ينبغي أن يتعامل مع أحمال عمل معينة. يمكن لـ Fugu أيضًا التوجيه ديناميكيًا حول قيود المزود. وهذا يجعل طبقة التنسيق أداة للامتثال، وليس فقط للجودة.
هذا هو الإطار الصادق، لأنه مهم لكيفية قراءة أي معيار. Fugu هو منسق يستدعي نماذج متقدمة من بائعين آخرين، بما في ذلك نفسه بشكل متكرر. لذا عندما تشير Sakana إلى أن Fugu Ultra "يقف جنبًا إلى جنب مع النماذج الرائدة مثل Fable 5 و Mythos Preview" عبر معايير الهندسة والعلوم والاستدلال، اقرأ ذلك على أنه ادعاء بالمساواة، يُنسب إلى Sakana، من نموذج النماذج، وليس فوزًا لنموذج واحد. تشير Sakana أيضًا إلى أن Fugu "يتفوق باستمرار" على Gemini 3.1 Pro و Opus 4.8 و GPT 5.5 في تطبيقات محددة مثل AutoResearch، والشطرنج بلقطة واحدة، والتنبؤ بالسلاسل الزمنية المالية. قد تأتي نتيجة مثل "يتفوق على Opus 4.8" من قيام Fugu باستدعاء Opus وتجميع مخرجاته. هذه قدرة حقيقية، وهي تختلف عن نموذج مستقل يتصدر لوحة المتصدرين. إذا كنت تريد التعمق في نماذج Anthropic الفردية التي يُقاس بها Fugu، فإن دليل واجهة برمجة تطبيقات Claude Fable 5 يغطي Fable 5 مباشرة. لمزيد من المعلومات حول نسب النموذج وقصة التنسيق، راجع ما هو Sakana Fugu.
ملاحظة حول الوصول والتسعير والبدائل
تم تأكيد هيكل التسعير في صفحة الإصدار: تقدم Sakana فئات اشتراك للاستخدام اليومي وخطة الدفع حسب الاستخدام لأحمال العمل الأكبر والمؤسسية. تأتي الأرقام الدولارية المحددة المتداولة للفئات والعروض الترويجية وأسعار كل رمز من مصادر ثانوية، تم عرضها بواسطة JavaScript، وليس من صفحة الإصدار نفسها. نظرًا لأن هذه الأرقام تتغير ولم تكن على الصفحة الرسمية، فإن هذا الدليل لا يقتبسها. تحقق من التسعير المباشر في وحدة التحكم الخاصة بك اعتبارًا من اليوم، 2026-06-22، قبل الالتزام بخطة.
إذا كنت تقوم بتقييم Fugu مقابل بوابات التوجيه، حافظ على الفئات واضحة. أجهزة التوجيه مثل OpenRouter و Martian تختار نموذجًا واحدًا لكل طلب. بينما يدير Fugu بنية تعلمية تكيفية يمكنها استخدام عدة نماذج ونفسها. إذا كنت تقارن البوابات لحزمتك، فإن مجموعتنا من أفضل بدائل OpenRouter هي نقطة بداية مفيدة، لأنها تحدد المفاضلات بين توجيه النموذج الواحد والتنسيق.
كيف يتناسب هذا مع سير عمل Apidog الخاص بك
نظرًا لأن Fugu يتحدث بتنسيق إكمال دردشة OpenAI، يمكنك اختباره بنفس الطريقة التي تختبر بها أي واجهة برمجة تطبيقات HTTP. ضع عنوان URL الأساسي من وحدة التحكم الخاصة بك في طلب جديد في Apidog، وأضف مفتاحك كرمز مميز لحامل، واضبط نص JSON باستخدام model و messages، ثم أرسل. سترى الاستجابة الأولية، بما في ذلك استخدام الرموز المميزة والرسالة المُركّبة، دون كتابة سطر واحد من التعليمات البرمجية للعميل. وهذا يجعل من السهل التأكد من صحة عنوان URL الأساسي الخاص بك، والتحقق من صحة سلسلة النموذج، ومشاهدة كيفية وصول أجزاء البث قبل توصيل Fugu بتطبيق.
يتيح لك Apidog أيضًا حفظ الطلب، وتحديد المفتاح عبر البيئات المختلفة، ومشاركة مثال عملي مع فريقك. للحصول على شرح مفصل، راجع دليلنا حول كيفية اختبار واجهة برمجة تطبيقات Sakana Fugu باستخدام Apidog. عندما تكون مستعدًا للبناء، قم بتنزيل Apidog وابدأ من طلب تم التحقق منه بدلاً من التخمين بشأن العقد.
الأسئلة المتكررة
هل أحتاج إلى SDK جديد لاستدعاء واجهة برمجة تطبيقات Sakana Fugu؟
لا. تعرض Fugu نقطة نهاية واحدة متوافقة مع OpenAI، لذا يمكنك الاحتفاظ بعميل openai Python أو JavaScript الحالي الخاص بك. قم بتغيير base_url إلى القيمة من وحدة التحكم الخاصة بك واضبط مفتاح API الخاص بـ Fugu. تتطابق أشكال الطلب والاستجابة مع إكمال دردشة OpenAI القياسية.
أين أجد عنوان URL الأساسي لـ Fugu؟
انسخه من لوحة التحكم الخاصة بك في console.sakana.ai بعد تسجيل الدخول باستخدام Google أو البريد الإلكتروني. لم يتم نشر عنوان URL الأساسي على أي صفحة عامة لـ Sakana، لذا لا تخمنه أو تعيد استخدام مضيف من مزود آخر. قيمة وحدة التحكم هي المصدر الوحيد الموثوق به.
ما الفرق بين Fugu و Fugu Ultra؟
Fugu هو الإصدار المتوازن ومنخفض زمن الاستجابة للعمل اليومي، والترميز، ومراجعة التعليمات البرمجية، والدردشة. يستهدف Fugu Ultra أقصى جودة للإجابة للبحث، واستنساخ الأوراق، وتحليل الأمان. يعمل كلاهما خلف نفس نقطة النهاية، لذا يمكنك التبديل عن طريق تغيير حقل model. كان الإصدار الأصغر يُطلق عليه "Fugu Mini" خلال مرحلة البيتا.
هل يتفوق Fugu على النماذج الفردية مثل Fable 5؟
تعامل مع هذا بحذر. تصور Sakana Fugu Ultra على أنه يقف جنبًا إلى جنب مع Fable 5 و Mythos Preview، وهو ادعاء بالمساواة، وليس ادعاء "بالتفوق". Fugu هو منسق يمكنه استدعاء نماذج متطورة من بائعين آخرين، لذا فإن أرقامه تعكس نموذجًا من النماذج بدلاً من فوز لنموذج واحد. راجع دليل واجهة برمجة تطبيقات Claude Fable 5 للحصول على نقطة مقارنة النموذج الواحد.
كم تكلفة واجهة برمجة تطبيقات Sakana Fugu؟
تؤكد صفحة الإصدار فئات الاشتراك بالإضافة إلى خطة الدفع حسب الاستخدام، لكن المبالغ الدولارية المحددة المتداولة تأتي من مصادر ثانوية وتتغير بمرور الوقت. تحقق من التسعير المباشر في وحدة التحكم الخاصة بك اعتبارًا من 2026-06-22 قبل الاشتراك. لا يقتبس هذا الدليل أرقامًا غير مؤكدة.
كيف أختبر Fugu قبل كتابة التعليمات البرمجية؟
أرسل طلبًا من عميل API مثل Apidog: الصق عنوان URL الأساسي لوحدة التحكم الخاصة بك، وأضف مفتاحك، واضبط model و messages، وافحص الاستجابة. يؤكد ذلك أن إعدادك يعمل قبل التكامل. يعرض دليل اختبار واجهة برمجة تطبيقات Sakana Fugu باستخدام Apidog التدفق الكامل.
يقوم Fugu بدمج نظام متعدد الوكلاء في استدعاء واحد متوافق مع OpenAI، مما يعني أن الجزء الأصعب في البدء هو مجرد نسخ عنوان URL الأساسي الصحيح من وحدة التحكم الخاصة بك. بمجرد الانتهاء من ذلك، يقوم عميلك الحالي بالباقي، ويوفر لك Apidog طريقة سريعة للتحقق من العقد قبل الشحن. قم بتنزيل Apidog وأرسل أول طلب Fugu لك من طلب نظيف وقابل للتكرار.