𝗧𝗿𝗼𝘂𝗯𝗹𝗲𝘀𝗵𝗼𝗼𝘁𝗶𝗻𝗴 𝗢𝗽𝗲𝗻𝗔𝗜 𝗕𝗮𝘀𝗲 𝗨𝗥𝗟𝘀
Kubadilisha mifano (models) kunapaswa kuwa rahisi. Unabadilisha endpoint na kubaki na SDK ile ile.
Katika miradi halisi, mara nyingi mara ya kwanza inafeli. Unaona makosa kama 401, 404, au 429.
Tumia orodha hii ya ukaguzi kabla ya kulaumu SDK.
Angalia kiambishi awali cha /v1 Milango mingi ya mawasiliano (gateways) inahitaji kiambishi tamati cha /v1 kwenye URL. Ukitumia domain pekee, SDK inaweza kuitia njia (path) isiyo sahihi. Nakili muundo sahihi kutoka kwenye hati (docs) za mtoa huduma.
Hakiki funguo zako za API Kuchanganya funguo husababisha makosa. Angalia makosa haya ya kawaida: • Kutumia funguo ya OpenAI pamoja na URL ya relay. • Kutumia funguo ya relay pamoja na URL ya OpenAI. • Kutumia funguo kutoka kwenye mradi uliowashwa (disabled). • Kuweka nafasi (space) mwanzoni au mwishoni mwa funguo. Ukiona kosa la 401, chapisha herufi ya kwanza na ya mwisho ya funguo yako ili kuilinganisha na dashboard yako. Usiweke kumbukumbu (log) ya funguo nzima.
Linganisha majina ya mifano (models) kwa usahihi Usikisie majina ya mifano. Majina ya gateway hubadilika. Jina lisilo sahihi husababisha makosa ya 404 au model_not_found. Nakili model ID moja kwa moja kutoka kwenye orodha ya mifano ya sasa.
Anza kwa kufanya ombi dogo sana Kabla ya kurekebisha hitilafu (debugging) kwenye programu yako nzima, fanya jaribio dogo. Tumia ujumbe rahisi wa "ping" na max_tokens ndogo. Ikiwa hili linafanya kazi, URL, funguo, na mfano wako ni sawa. Hitilafu yako iko kwenye mantiki ya programu yako (app logic), kama vile streaming au tool calling.
Elewa nambari za makosa (error codes) • 401 inamaanisha tatizo la funguo au akaunti. • 429 inamaanisha tatizo la kikomo cha kasi (rate limit) au salio. Ukiona 429, kagua ukurasa wako wa malipo (billing page). Epuka mizunguko ya marudio (retry loops) inayozidi. Hufanya tatizo kuwa baya zaidi.
Kagua ukurasa wa hali (status page) Ikiwa kodi yako ilifanya kazi jana lakini inafeli leo, usiuandike upya uunganishaji (integration) wako. Kagua ukurasa wa hali wa mtoa huduma kwanza. Mara nyingi chanzo ni tukio la upande wa mtoa huduma (upstream incident).
Tumia amri ya curl Weka amri rahisi ya curl kwenye hati za mradi wako.
Programu yako inapofeli, anza kwa kuendesha amri ya curl. Ikiwa curl inafeli, tatizo ni akaunti, gateway, au mtandao. Ikiwa curl inafanya kazi, tatizo ni kodi ya programu yako.