በAPI ቁልፍ ማረጋገጥ

ይህ ገጽ በCLEVI ጌትዌይ ላይ በAPI ቁልፍ እንዴት ማረጋገጥ እንደሚቻል ይገልጻል።
ለOpenAI ተኳሃኝ መንገድ እና ለAnthropic ተኳሃኝ መንገድ ሁለቱም በአንድ ቁልፍ ይረጋገጣሉ፤
ቁልፉን የሚያካትት ራስጌ የሚፈቀድበት ወሰን እና በSDK ውስጥ የሚዋቀረው base URL እንደ ዝርዝሩ ይለያያሉ።

የማረጋገጫ ራስጌ

ሁለቱም ተኳሃኝ ዝርዝሮች በአንድ API ቁልፍ ይረጋገጣሉ። ቁልፉ ከኮንሶሉ API ቁልፍ ገጽ ይፈጠራል፤ በዚያው ገጽ ላይ ማስወገድን እና የአጠቃቀም ወሰንን ያስተዳድራሉ።

የራስጌ ስም በአቢይና በትንሽ ፊደል ልዩነት አያደርግም። በAnthropic SDK የሚላከው x-api-key እንዳለ ይሰራል።

base URL

የሚጠቀሙበትን SDK በታች ባለው አድራሻ base URL ብቻ በመቀየር እንደነበረ መጠቀም ይችላሉ። ሁለቱ አድራሻዎች /v1 ያካትቱ እንደሆነ ይለያያሉ።

ማረጋገጫን መፈተሽ

ቁልፉን እና base URLን አስገብተው የሞዴሎችን ዝርዝር ሲጠይቁ ማረጋገጫ መኖሩን ወዲያውኑ ማወቅ ይችላሉ። ከታች ያሉት ሶስት ምሳሌዎች ተመሳሳይ ጥያቄን በcurl፣ OpenAI SDK እና Anthropic SDK ያቀርባሉ።

curl https://platform.clevi.net/api/v2/aiservice/openai/v1/models \
  -H "X-API-Key: sk-..."

curl https://platform.clevi.net/api/v2/aiservice/anthropic/v1/models \
  -H "Authorization: Bearer sk-..." \
  -H "anthropic-version: 2023-06-01"

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://platform.clevi.net/api/v2/aiservice/openai/v1",
)

for model in client.models.list():
    print(model.id)

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-...",
    base_url="https://platform.clevi.net/api/v2/aiservice/anthropic",
)

for model in client.models.list(limit=20).data:
    print(model.id)

በsk-... ቦታ ላይ ከAPI ቁልፍ ገጽ የፈጠሩትን ቁልፍ ያስገቡ።

• ምላሹ 200 ከሆነ ማረጋገጫው ተሳክቷል። data በዚህ ቁልፍ መጠቀም የሚችሉትን የሞዴሎች ዝርዝር ይዟል።
• ምላሹ 401 ከሆነ ከታች ባለው የማረጋገጫ አለመሳካት ክፍል በተሰጠው ቅደም ተከተል ይፈትሹ።

በጋራ የሚጠቀሙት ራስጌ

ሁሉም አማራጭ ናቸው። ችግሩን ለመከታተል X-Request-Id ማካተት ይመከራል።

የማረጋገጫ አለመሳካት

ቁልፍ ከሌለ ወይም ጊዜው ያለፈበት·የተሰረዘ ቁልፍ ከተላከ 401 ይመለሳል። በOpenAI ተኳሃኝ መንገድ ላይ ያለ ቁልፍ ሳይኖር ጥሪ ካደረጉ፣ ከታች ያለው አካል ይመጣል፤ በAnthropic ተኳሃኝ መንገድ ደግሞ error.type authentication_error ነው።

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

1. በAPI ቁልፍ ገጹ ላይ የቁልፉን ሁኔታ ያረጋግጡ። ጊዜው ያለፈበት·የተሰረዘ ቁልፍ ከሆነ አዲስ ያውጡ።
2. የራስጌው ስም X-API-Key ወይም Authorization መሆኑን ያረጋግጡ።
3. በOpenAI ተኳሃኝ መንገድ Authorization ከተጠቀሙ፣ Bearer ቅድመ ቅጥያውን ያረጋግጡ።