Developer guide
Met ’n API-sleutel staafwerk verifieer
Die kopskrif waarin die API-sleutel geplaas word en die basis-URL wat in die SDK gestel moet word
Hierdie bladsy handel oor hoe om met ’n API-sleutel by die CLEVI-gateway te staafwerk.
Beide die OpenAI-versoenbare roete en die Anthropic-versoenbare roete word met een sleutel geverifieer,
maar die toegelate kopskrif vir die sleutel en die basis-URL wat in die SDK gestel moet word, verskil volgens die spesifikasie.
Staafwerkkopskrif
Beide versoenbare spesifikasies word met een API-sleutel geverifieer. Die sleutel word op die API-sleutel-skerm in die konsole uitgereik, en herroeping en gebruiksbereik word op dieselfde skerm bestuur.
| Kopskrif | OpenAI-versoenbaar | Anthropic-versoenbaar |
|---|---|---|
| X-API-Key: <키> | Beskikbaar | Beskikbaar |
| Authorization: Bearer <키> | Beskikbaar | Beskikbaar |
| Authorization: <키> (sonder Bearer) | Verwerp | Beskikbaar |
Kopskrifname is nie hooflettergevoelig nie. x-api-key wat deur die Anthropic SDK gestuur word, werk ook onveranderd.
basis-URL
Die SDK wat jy gebruik het, werk onveranderd as jy net die basis-URL na die onderstaande adres verander. Die twee adresse verskil daarin of /v1 ingesluit word.
| Spesifikasie | basis-URL | Padreël |
|---|---|---|
| OpenAI-versoenbaar | https://platform.clevi.net/api/v2/aiservice/openai/v1 | Sluit /v1 by die basis-URL in. |
| Anthropic-versoenbaar | https://platform.clevi.net/api/v2/aiservice/anthropic | Die Anthropic SDK voeg self /v1 by die pad, dus eindig dit voor /v1. |
Verifiëring van staafwerk
Jy kan onmiddellik vasstel of staafwerk geverifieer is deur die sleutel en basis-URL in te vul en die modell lys op te vra. Die drie voorbeelde hieronder voer dieselfde navraag met curl, OpenAI SDK en Anthropic SDK uit.
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)Plaas die sleutel wat op die API-sleutel-skerm uitgereik is in die plek van sk-....
- As die antwoord 200 is, is staafwerk geverifieer. data bevat die lys modelle wat met hierdie sleutel aangeroep kan word.
- As die antwoord 401 is, volg die volgorde in die afdeling oor staafwerkfaling hieronder om dit na te gaan.
Kopskrifte wat saam gebruik word
Alles is opsioneel. Om probleme op te spoor, is dit raadsaam om X-Request-Id in te sluit.
| Opskrif | Gebruik | Indien weggelaat |
|---|---|---|
| X-Request-Id | Identifiseerder vir die naspoor van versoeke. In Anthropic-versoenbare antwoorde word dit as die request-id-opskrif teruggestuur. | Die bediener reik dit uit. |
| X-Region-Code | Streek waarin die oproep gemaak word | Dit is global. |
| X-Product-Sku (ook moontlik as die product_sku-navraagparameter) | Spesifiseer die Product SKU wat direk vir fakturering gebruik moet word. Die opskrif het voorrang bo die navraagparameter en word hoofsaaklik vir stem- en voice-roetes gebruik. | Dit is nodig vir voice-roetes. Vir audio/speech en audio/transcriptions word die Product met die model in die liggaam gekies. |
| anthropic-version / anthropic-beta | Dit word onveranderd deur Anthropic-versoenbare roetes gestuur. | Die weergawe is 2023-06-01. |
Verifikasiemislukking
As jy geen sleutel of ’n sleutel wat verval of herroep is, stuur, is die antwoord 401. Wanneer jy ’n OpenAI-versoenbare roete sonder ’n sleutel oproep, word die onderstaande liggaam teruggestuur, en error.type in ’n Anthropic-versoenbare roete is authentication_error.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}- Gaan die sleutelstatus op die API-sleutelskerm na. As die sleutel verval of herroep is, reik ’n nuwe een uit.
- Bevestig of die opskrifnaam X-API-Key of Authorization is.
- As jy Authorization in ’n OpenAI-versoenbare roete gebruik, bevestig die Bearer-voorvoegsel.
