pelrêça gotarê
Çima URL-ya bingehîn a AI-ya Cloudflare-ya min her tim çewtiyek 404 vedigerîne?
Ev gotar di çend saniyan de fêrî we dike ka meriv çawa bi lez URL-yek bingehîn a OpenAI-ya lihevhatî ya Cloudflare-ê bi dest dixe û mîheng dike. Ew şablonên bêkêmasî ji bo API-ya REST a fermî, formata AI Gateway, û xerîdarên partiya sêyemîn (Dify/One-API) vedihewîne, ku ji we re dibe alîkar ku hûn API-yên AI-ê yên belaş bi yek klîkekê bidin xebitandin!
Hefteya borî, hevalekî min ê ku pêşxistina serbixwe dike ji nişkê ve bi min re têkilî danî û dîmenek ji ekranê şand ku dîmenderek tijî 401 xeletiyan nîşan dida. Wî got, "Bira, ez tevahiya rojê hewl didim API-ya AI ya Cloudflare debug bikim, lê ew tenê kar nake."
Min li koda wî nihêrî. URL-ya bingehîn wekî /ai/v1 hatibû danîn, lê laşê daxwazê wekî API-ya REST-a fermî hatibû formatkirin, ji ber vê yekê herdu qet li hev nekirin.
Wî got ku ew tenê dixwaze SDK-ya OpenAI-yê bikar bîne da ku modelek li ser AI-ya Karkeran debug bike, gelo pirsgirêkek heye?
Ev pirsgirêkek mezin e.
Xizmetên AI yên Cloudflare li gorî senaryoyê sê URL-yên bingehîn ên bi tevahî cuda bikar tînin. Her yek ji wan xwedî formata xwe û senaryoyên guncaw e. Her çend belgekirin hebe jî, ew li ser rûpelên cûda belav bûne, ev yek jî dihêle ku hûn di ceribandina xwe ya yekem de bizanin ka kîjan ji wan divê hûn serî lê bidin. Bikaranîna URL-ya xelet dê bibe sedema xeletiyek 401 an 400, ku rê li ber gihîştina we ya xizmetê digire.
Dema ku ez cara yekem rastî vê pirsgirêkê hatim, min çend caran ceriband berî ku ez wê çareser bikim. Ez bêdeng li ekrana tijî peyamên çewtiyê dinihêrîm.
Îro ez ê van hersê rêyan bi zelalî ji bo we xêz bikim, da ku hûn piştî xwendina vê yekê êdî şaşiyan nekin.
URL-ya bingehîn a navrûya lihevhatî ya OpenAI
Ka em bi ya herî gelemperî dest pê bikin.
Eger hûn OpenAI SDK, an amûrên ku piştgirîya formatên OpenAI yên xwerû yên wekî LangChain, Dify, NextChat, an One-API dikin bikar tînin, wê hingê ev rêbaza rast e.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Ev tiştek e ku Cloudflare bi taybetî ji bo lihevhatina bi formata navrûya OpenAI-yê re sêwirandiye. Piştî xala dawiya diyalogê ya temam `/chat/completions` lê zêde bike. URL-ya xwe ya bingehîn a OpenAI-yê bi vê biguherîne, û Mifteya API-yê bi nîşana xwe ya Cloudflare-yê biguherîne, û divê ew rasterast bixebite. Min modelên wekî `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` û `@cf/meta/llama-3.1-8b-instruct` ceribandiye, û ew hemî baş dixebitin.
Lêbelê, divê were zanîn ku ev tenê modelên diyalogê yên li ser bingeha nivîsê piştgirî dike.
API-ya REST-ê ya xwemalî ya fermî ya Cloudflare
Eger pêwîstiya te bi karanîna Stable Diffusion ji bo grafîkê, Whisper ji bo nivîsandina deng, an jî her modelek ne-nivîsî hebe, rêya duyemîn hilbijêre, ku ew jî API-ya REST a xwemalî ya fermî ya Cloudflare ye.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
Navê modelê dikare di rê de were nivîsandin, wek /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, an jî dikare di qada `model` a laşê daxwazê de were danîn. Ez tercîh dikim ku wê di qadê de bixim; rê kurttir û paqijtir e. Ez jî di destpêkê de di derbarê vê hûrguliyê de şaş bûm. Hin model her du rêbazan qebûl dikin, hinên din jî tenê yekê qebûl dikin. Dema ku hûn belgeyan kontrol dikin, bala xwe bidin vê yekê.
URL-ya bingehîn a Deriyê AI-ê
Rêyek sêyemîn heye: AI Gateway.
Ev senaryo hinekî cuda ye. Heke we di backend-a Cloudflare de Dergehek AI-ê saz kiribe da ku API-yên partiya sêyemîn wekî proxy bike, wekî şandina daxwazên OpenAI-ê bi rêya deriyê Cloudflare ji bo caching, çavdêrîkirin û sînorkirina rêjeyê, wê hingê URL-ya bingehîn dê bibe...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
Zêdekirina `/chat/completions` piştî xala dawî ya temam piştrast dike ku hemî trafîk di deriyê Cloudflare re derbas dibe, û panela têketinê derengmayîn û encama her daxwazek nîşan dide. Ev taybetmendî pir bikêrhatî ye ji ber ku tîm bi projeyên bêtir mezin dibe, û hewcedariya lêgerîna daneyan ji paşxaneyên firoşkarên cûrbecûr yek bi yek ji holê radike.
Çawa hilbijêrin: Sê setên URL-an di hevokekê de hatine ravekirin.
Başe, ev hersê rêyan vedihewîne. Bi kurtasî, tenê yek prensîb heye.
Riya ku hûn hildibijêrin bi amûrên ku hûn bikar tînin ve girêdayî ye.
Ji bo bikaranîna OpenAI SDK ji bo gazîkirina modelek diyalogê, biçin `/ai/v1`. Ji bo gazîkirina modelek wêne/deng, biçin `/ai/run`. Ji bo rêveberiya yekgirtî bi rêya dergehekê, biçin `/gateway/`. Rêbaza pejirandinê eynî ye: `Authorization: Bearer` û dûv re API-ya xwe di sernavê de binivîsin. Tokenê di backendê Cloudflare de biafirînin, û ji bîr mekin ku destûra `Workers AI: Edit` kontrol bikin.
Li ku derê account_id-ê bibînim? Têkeve panela rêveberiya Cloudflare-a xwe, ber bi jêr ve biçe beşa API-yê ya li milê rastê, an jî li barika navnîşana geroka xwe kontrol bike; ew rêza alfanumerîk a 32-karakterî ew e.
Bi rastî, piştî ku min wê rojê alîkariya hevalê xwe kir ku wê yekê biqedîne, wî tiştek ji min re got ku ez difikirim pir rast e: ne ew bû ku min nizanibû çawa, lê ew bû ku belgeyan ew bi zelalî ji min re rave nekiribû.
Gelek mîhengên teknîkî bi vî rengî ne. Ne ku ew pir dijwar in, lê pir xalên ketinê hene, ku di hewla we ya yekem de windabûn hêsan dike. Ger hûn dema mîhengkirina Cloudflare AI-ê rastî gelek xeletiyên nepenî hatibin, ew bi îhtîmaleke mezin ji ber URL-ya bingehîn a xelet an formata xelet e. Van sê komên URL-an li ber destê xwe bigirin; hûn dikarin cara din bi hêsanî ya rast bibînin.
Rica dikim.
Ji ber vê yekê, ji ber ku we heta niha xwendiye, heke we ew kêrhatî dît, ji kerema xwe ecibînin û parve bikin. Heke hûn dixwazin pêşî nûvekirinan bistînin, hûn dikarin min jî bişopînin! ⭐
Spas ji bo xwendina gotara min. Careke din hevdû dibînin.
Hêvîdarim, gotara "Raporkirina Çewtiyan Rawestîne! Bi Hêsanî Cloudflare Ji Bo Lihevhatina OpenAI Mîheng Bike" ku li ser bloga Chen Weiliang ( https://www.chenweiliang.com/ ) hatiye parvekirin, ji we re bibe alîkar.
Ji kerema xwe vê girêdana gotarê parve bikin: https://www.chenweiliang.com/cwl-34252.html