Developer guide

Fanamarinana amin'ny API key

Header hampidirana ny API key sy ny base URL hapetraka ao amin'ny SDK

Ity pejy ity dia manazava ny fomba fanamarinana amin'ny API key ao amin'ny vavahadin'ny CLEVI.
Samy mampiasa key iray ny lalana mifanaraka amin'ny OpenAI sy ny lalana mifanaraka amin'ny Anthropic,
fa samy hafa arakaraka ny fepetra ny faritra azo ampiasana ny header misy ny key sy ny base URL hapetraka ao amin'ny SDK.

Header fanamarinana

Samy manamarina amin'ny API key iray ireo fepetra roa mifanaraka ireo. Omena ao amin'ny pejin'ny API keys ao amin'ny console ny key, ary ao amin'io pejy io ihany koa no itantanana ny fanafoanana sy ny faritra azo ampiasana azy.

HeaderMifanaraka amin'ny OpenAIMifanaraka amin'ny Anthropic
X-API-Key: <키>Azo ampiasainaAzo ampiasaina
Authorization: Bearer <키>Azo ampiasainaAzo ampiasaina
Authorization: <키> (tsy misy Bearer)LavinaAzo ampiasaina

Tsy manavaka sora-baventy sy sora-malefaka ny anaran'ny header. Miasa toy izao ihany koa ny x-api-key alefan'ny Anthropic SDK.

base URL

Ny SDK nampiasainao dia mbola hiasa raha ovaina ho amin'ireo adiresy etsy ambany ihany ny base URL. Ny fahasamihafan'ireo adiresy roa dia ny fisian'ny /v1 na tsia.

Fepetrabase URLFitsipiky ny lalana
Mifanaraka amin'ny OpenAIhttps://platform.clevi.net/api/v2/aiservice/openai/v1Ampidiro ao amin'ny base URL hatramin'ny /v1.
Mifanaraka amin'ny Anthropichttps://platform.clevi.net/api/v2/aiservice/anthropicNy Anthropic SDK no manampy ho azy ny /v1 ao amin'ny lalana, ka mifarana alohan'ny /v1.

Fanamarinana ny fanamarinana

Rehefa ampidirinao ny key sy ny base URL ary alaina ny lisitry ny modely, dia ho fantatra avy hatrany raha voamarina ianao. Ireto telo etsy ambany ireto dia manao ilay fakana mitovy amin'ny curl, OpenAI SDK ary 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)

Ao amin'ny toeran'ny sk-... dia ampidiro ny key nomena tao amin'ny pejin'ny API keys.

  • Raha 200 ny valiny dia voamarina ny fanamarinana. Ao amin'ny data no misy ny lisitry ny modely azo antsoina amin'ity key ity.
  • Raha 401 ny valiny dia jereo araka ny filaharana ao amin'ny fizarana momba ny tsy fahombiazan'ny fanamarinana etsy ambany.

Header ampiasaina miaraka

Safidy avokoa ireo. Raha te hanara-maso olana, tsara ny mampiditra X-Request-Id.

LohatenyFampiasanaRaha avela
X-Request-IdFamantarana ampiasaina hanarahana ny fangatahana. Amin'ny valinteny mifanaraka amin'i Anthropic, dia averina ho lohateny request-id izy.Ny mpizara no mamoaka azy.
X-Region-CodeFaritra iantsoanaglobal izy.
X-Product-Sku (azo ampiasaina koa amin'ny product_sku ao amin'ny query)Manondro mivantana ny Product SKU hampiasaina amin'ny faktiora. Ny lohateny no manana laharam-pahamehana noho ny query, ary ampiasaina indrindra amin'ny lalan'ny feo/voice.Ilaina amin'ny lalan'ny voice. Ny audio/speech sy audio/transcriptions dia misafidy ny Product amin'ny model ao amin'ny vatana.
anthropic-version / anthropic-betaAmpitaina tsy miova amin'ny lalan'ny fifanarahana amin'i Anthropic.2023-06-01 ny dikan-teny.

Tsy nahomby ny fanamarinana

Raha tsy misy fanalahidy na mandefa fanalahidy lany daty na nofoanana ianao, dia 401 no valiny. Raha miantso tsy misy fanalahidy amin'ny lalan'ny fifanarahana amin'i OpenAI, dia miseho ny vatana etsy ambany, ary ny error.type ao amin'ny lalan'ny fifanarahana amin'i Anthropic dia authentication_error.

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}
  1. Hamarino ao amin'ny pejin'ny fanalahidin'ny API ny satan'ny fanalahidy. Raha lany daty na nofoanana ilay izy, mamoròna vaovao.
  2. Hamarino raha X-API-Key na Authorization no anaran'ny lohateny.
  3. Raha mampiasa Authorization amin'ny lalan'ny fifanarahana amin'i OpenAI, hamarino ny tovona Bearer.
CLEVI

Fiteny sy faritra

Voamarika ireo fiteny nadika tamin’ny milina. Miankina amin’ny fitambaran’ny tranonkala navoaka ny fahafahana mampiasa azy.

Fiteny 136

Atolotra

1

Azia Atsinanana

7

Azia Atsimo Atsinanana

11

Azia Atsimo

18

Azia Afovoany

5

Afovoany Atsinanana sy Kaokazy

10

Eoropa Andrefana sy Atsimo

16

Grande-Bretagne sy Irlandy

4

Eoropa Avaratra sy Baltika

10

Eoropa Afovoany sy Balkana

14

Eoropa Atsinanana

5

Afrika Atsinanana sy ny Tandroka

8

Afrika Andrefana sy Afovoany

9

Afrika Atsimo

8

Amerika

5

Pasifika

5