API و یەکخستنەکان
بەرنامەیەک بە بەڵگەنامەی inference API یان model-training API، زانیاریی چوونەژوورەوەی سنووردار و سەرچاوەی ئێستاییی بەکارهێنان و API پەیوەست بکە.
- بەرهەمی API هەڵبژێرەداواکاریی inference لە ڕەوتی کاری model-training جیا بکەرەوە.
- گرێبەستی بەکارهێنانی بخوێنەوەبەڵگەنامەی API و سەرچاوەی OpenAPIی گونجاو بەکاربهێنە.
- کلیلێکی سنووردار دروست بکەکلیلی APIی کڕیار بە ئاسایش دروست و هەڵبگرە.
- یەکخستن جێبەجێ و پشتڕاست بکەرەوەداواکارییەکی بەڵگەکراو بنێرە و وەڵامەکەی بپشکنە.
- چاودێری و گۆڕینی کلیل بکەبەکارهێنان بپشکنە و کلیل کاتێک گونجاو بوو هەڵبوەشێنەوە یان بیگۆڕە.
ڕەوتی کاری APIی دروست هەڵبژێرە
Inference API داواکاریی inferenceی مۆدێل جێبەجێ دەکات، لە کاتێکدا model-training API ڕەوتێکی جیاوازی ڕاهێنان بە نرخ، کار، دانیشتن و بەرهەمەکانەوە بەڵگە دەکات. گریمانە مەکە endpointی inference ڕاهێنان دەست پێ دەکات یان کردارێکی ڕاهێنان لە contractی inferenceدا بەردەستە. بەڵگەنامەی بەرهەمی مەبەست بخوێنەوە و پشتڕاست بکەرەوە مۆدێل یان توانا لست کراوە. شێوەی داواکاری و وەڵامی بڵاوکراوە بەکاربهێنە، نەک ناوی مێتۆد لە SDKی لایەنی سێیەمی ناسراوەوە دروست بکەیت.
- دیاری بکە بەرنامەکە inference دەوێت یان ڕاهێنانی مۆدێل.
- بەڵگەنامە و سەرچاوەی APIی بەرهەمی گونجاو بکەرەوە.
- دڵنیا ببە لە توانای داواکراو و مۆدێل بەڵگە کراون.
کلیلی API دروست بکە و بیپارێزە
کلیلی APIی کڕیار لە پەڕەی کلیلی APIی چوونەژوورەوەکراو دروست بکە و ئەگەر ڕووکارەکە هەڵبژاردەی scope پێشکەش کرد، تەنها ئەو scopeانە دیاری بکە کە یەکخستنەکەت پێویستی پێیەتی. secret تەنها یەک جار پیشان دەدرێت؛ ڕاستەوخۆ بیخە ناو secret managerی پەسەندکراو و مەیخەرە ناو کۆنترۆڵی سەرچاوە، لە تۆمارەکاندا مەیخەرەوە و لە کۆدی وێبگەڕدا ئاشکرای مەکە. ئەگەر دەکرێت زانیاریی چوونەژوورەوە بەپێی بەرنامە و ژینگە ناونیشان بکە. بۆ ژینگەی گەشەپێدان و بەرهەمهێنان زانیاریی جیا بەکاربهێنە بۆ ئەوەی بتوانرێت یەکێک هەڵبوەشێنرێتەوە بێ ئەوەی یەکخستنی دیکە بوەستێت.
- لە شوێنی کاری کڕیاری چوونەژوورەوەکراو کلیلی API بکەرەوە.
- کلیلێک بە کەمترین scopeی پێویست دروست بکە.
- secret بە ئاسایش هەڵبگرە و لە کۆدی سەرچاوە و تۆمارەکان دووری بخەرەوە.
بەپێی گرێبەستی بەڵگەکراو جێبەجێ بکە
ڕێنمایی APIی پەیوەندیدار بۆ پشتڕاستکردنەوە، endpoint، خانەکانی داواکاری، مامەڵەکردن لەگەڵ وەڵام و هەڵەکان جێبەجێ بکە. زانیاریی چوونەژوورەوەی خزمەتگوزاری لە سێرڤەرێکی متمانەپێکراو بهێڵەرەوە، نەک لە کۆدی کڕیاری گشتی. پێش ناردن داتا پشتڕاست بکەرەوە، وەڵامی ناسوەرکەوتوو بە ڕوونی چارەسەر بکە، و headerی دەسەڵات یان زانیاریی هەستیاری prompt تۆمار مەکە. کاتێک گرێبەستی ماشینی بڵاوکراوە دەوێت سەرچاوەی OpenAPI بەکاربهێنە. گواستنەوەی streaming، media یان کرداری provider-native گریمانە مەکە، مەگەر بەڵگەنامەی ئێستا بە ڕوونی لستیان بکات.
- تەنها کردار و خانەکانی بەڵگەکراو بۆ APIی هەڵبژێردراو جێبەجێ بکە.
- زانیاریی چوونەژوورەوە لە سێرڤەر بهێڵەوە و لە تۆمارەکان بیشارەوە.
- هەڵە بەڵگەکراوەکان چارەسەر بکە و ناسنامەی داواکاری بپارێزە ئەگەر نێردرا.
بەکارهێنان چاودێری بکە و زانیاریی چوونەژوورەوە بەڕێوە ببە
دوای یەکخستن پەڕەی بەکارهێنان بپشکنە بۆ تێگەیشتن لە چالاکیی هەژمارەکەت و بەراوردکردنی لەگەڵ تۆمارەکانی بەرنامەکەت. پێش زیادکردنی ترافیک یان دروستکردنی زانیاریی چوونەژوورەوەی زیادە گۆڕانکاریی نائاسایی لێکۆڵینەوەی بکە. ئەگەر کلیلێک لەوانەیە ئاشکرا بووبێت بیگۆڕە، پاشان دواتر لەsecret storeی بەرنامە نوێی بکەرەوە و پێش سڕینەوەی هەر کلیلێکی کۆن یەکخستنەکە پشتڕاست بکەرەوە. کلیلە پێویست‌نەماوەکان هەڵبوەشێنەوە. پیشاندانی بەکارهێنان پشتگیریی پێداچوونەوەی ئۆپەراسیۆنی دەکات، بەڵام گەرەنتیی تێچووی داهاتوو یان توانای بەردەست نییە.
- بەکارهێنانی پلاتفۆرم لەگەڵ تۆماری داواکاریی بەرنامە بەراورد بکە.
- کلیلی ئاشکراوبوو بگۆڕە و کلیلی جێگرەوە پشتڕاست بکەرەوە.
- کلیلە بەکارهێنانەکراوەکان هەڵبوەشێنەوە و بەردەوام دەستگەیشتن بپشکنە.
پرسیارە باوەکان
ئایا inference و ڕاهێنانی مۆدێل هەمان APIن؟
نەخێر. دوو بەرهەمی جیاوازن و ڕەوتی کاری بەڵگەکراوی جیاوازیان هەیە. سەرچاوەی توانای پێویست بەکاربهێنە.
گرێبەستی APIی پشتگیریکراو لە کوێ بدۆزمەوە؟
بەڵگەنامەی بەرهەم و سەرچاوەی OpenAPIی بەستراو بە ئەم ڕێنماییە بەکاربهێنە. ڕووکاری ئێستای بڵاوکراوە ڕوون دەکەنەوە.
نهێنیی API لە کوێ هەڵبگرم؟
secret managerێکی پارێزراوی لای سێرڤەر بەکاربهێنە. هەرگیز لە زەخیرەگای کۆد مەیخەرەوە، لە کۆدی وێبگەڕدا ئاشکرای مەکە یان لە تۆمارەکاندا مەینوسە.
ئەگەر کلیلێک ئاشکرا بوو چی بکەم؟
لە بەشی کلیلی API بیگۆڕە یان هەڵیوەشێنەوە، لە secret storeی بەرنامە نوێی بکەرەوە و بەکارهێنانی ئێستای بۆ چالاکیی نائاسایی بپشکنە.