Pag-authenticate gamit ang API key

Kini nga panid naghisgot kung giunsa pag-authenticate sa CLEVI gateway gamit ang API key.
Ang OpenAI-compatible nga agianan ug Anthropic-compatible nga agianan parehas nga naggamit og usa ka key para sa authentication,
apan lahi ang gitugot nga mga header nga butangan sa key ug ang base URL nga i-set sa SDK depende sa espesipikasyon.

Authentication header

Ang duha ka compatible nga espesipikasyon naggamit og usa ka API key para sa authentication. Ang key i-isyu sa API key screen sa console, ug sa samang screen mahimong dumalahon ang pag-revoke ug sakop sa paggamit.

Dili sensitibo sa uppercase o lowercase ang ngalan sa header. Ang x-api-key nga ipadala sa Anthropic SDK molihok usab diretso.

base URL

Ang SDK nga imong gigamit magpadayon sa pagtrabaho kung ilisan lang ang base URL sa adres sa ubos. Lahi ang duha ka adres kon apil ba niini ang /v1.

Pagkumpirma sa authentication

Kung i-set ang key ug base URL ug pangitaon ang listahan sa mga modelo, mahibalo dayon ka kung na-authenticate ba. Ang tulo sa ubos mohimo sa samang pagpangita gamit ang curl, OpenAI SDK, ug 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)

Ibutang ang key nga gi-isyu sa API key screen sa dapit sa sk-....

• Kung 200 ang tubag, na-authenticate na. Ang data naglangkob sa listahan sa mga modelo nga mahimong tawgon gamit kini nga key.
• Kung 401 ang tubag, susiha kini sumala sa han-ay sa seksyon nga Napakyas ang authentication sa ubos.

Mga header nga gamiton dungan

Opsyonal ra tanan. Aron masubay ang problema, mas maayong ibutang ang X-Request-Id.

Napakyas ang awtorisasyon

Kung walay yawe o nagpadala ka og yawe nga na-expire o gibawi na, 401 ang resulta. Kung motawag nga walay yawe sa OpenAI-compatible path, madawat ang lawas sa ubos, ug ang error.type sa Anthropic-compatible path kay authentication_error.

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

1. Susihon ang kahimtang sa yawe sa screen sa API key. Kung na-expire o gibawi na, paghimo og bag-ong yawe.
2. Susihon kung X-API-Key o Authorization ang ngalan sa header.
3. Kung mogamit og Authorization sa OpenAI-compatible path, susihon ang Bearer prefix.