Kusimbisa

Authorization: Bearer YOUR_API_KEY

x-api-key: YOUR_API_KEY

Headers dzinogamuchirwa

Ma-header ese maviri anoverengwa pa-/v1 endpoint imwe neimwe, chero format ipi inotaurwa ne-endpoint. Tumira imwe yawo.

Ne-OpenAI SDK, isa key ne-base URL; SDK inotumira Authorization: Bearer.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

response = client.chat.completions.create(
    model="shannon-3",
    messages=[
        {"role": "user", "content": "Hello, Shannon!"}
    ]
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const response = await client.chat.completions.create({
  model: 'shannon-3',
  messages: [
    { role: 'user', content: 'Hello, Shannon!' }
  ]
});

console.log(response.choices[0].message.content);

curl -X POST "https://api.shannon-ai.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-3",
    "messages": [
      {"role": "user", "content": "Hello, Shannon!"}
    ]
  }'

Ne-Anthropic SDK, isa key ne-base URL isina /v1; SDK inotumira x-api-key.

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com"
)

message = client.messages.create(
    model="shannon-3",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Shannon!"}
    ]
)

print("".join(block.text for block in message.content if block.type == "text"))

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com'
});

const message = await client.messages.create({
  model: 'shannon-3',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'Hello, Shannon!' }
  ]
});

console.log(message.content.filter((block) => block.type === 'text').map((block) => block.text).join(''));

curl -X POST "https://api.shannon-ai.com/v1/messages" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-3",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Shannon!"}
    ]
  }'

Ndedzipi endpoints dzinoda key

Key yako

• Key ndi-sk- inoteverwa ne-characters 43 kubva ku-A–Z, a–z, 0–9, - ne-_: characters 46 pamwe chete.
• Account imwe neimwe ine key imwe chete. Inogadzirwa pawakatanga kuvhura Keys & usage.
• Key inopa kuwana kwakazara kuAPI ye-account yako: endpoint dzese, ma-model ese ne-balance yose.
• Key haina zuva rekupera. Inoshanda kusvika wakaichinja kana kuibvisa.

Chinja nekubvisa

Unochinja nekubvisa key papeji reKeys & usage. Keys & usage

• Zvese zviri zviviri zvinoshanda pakarepo: request inotevera ne-key yekare inopindurwa ne-401. Tora masekonzi 60 sepamusoro pekupedzisira kusati kwarambwa key yekare kwese kwese.
• Ma-client ese e-account anoshandisa key imwechete, saka kuchinja kunosvika kwavari vese. Isa key itsva mu-ma-client ako pakarepo mushure mekuchinja.
• Balance, usage ne-flood protection ndzve-account, kwete ye-key. Key itsva inoenderera ne-balance imwechete uye huwandu hwe-request hwakafanana hwaminiti yazvino.

Errors

Kundikana kwese kwe-authentication kune status 401 ne-type authentication_error. Message inosiyanisa nyaya.

{
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

• Pa-path dzese kunze kwe-/v1/messages error object ine zvakare code: "invalid_api_key", kunyange key isipo, ne-param: null.
• Key inotariswa body isati yaverengwa. Request isina key chaiyo inowana 401 kunyange body yayo isiri chaiyo kana yakakura kwazvo.
• Authorization: Bearer value isingatanga ne-sk- haitorwi seAPI key. Inowana 401 ine message inoti token haina kunaka kana yapera nguva.

Browsers ne-CORS

• API inopindura cross-origin browser requests chete kune rondedzero yakatarwa ye-origins. JavaScript iri pa-peji re-origin imwe haigoni kuverenga /v1 replies.
• Danidzira API kubva pa-server yako uye siya peji rako richitaura ne-server yako. Izvi zvinochengeta key kunze kwe-page source.
• Server-side code ne-command-line tools hazvikanganiswi: mutemo uyu unoshandiswa ne-browsers chete.
• Kupinda pa-shannon-ai.com hakusimbisi /v1 requests. Cookies hadziverengwi ipapo; key ndiyo credential imwe chete.
• Kune origin inobvumirwa, browser inogona kutumira content-type, authorization, x-api-key, anthropic-version, anthropic-beta, openai-beta ne-x-request-id, uye inogona kuverenga reply header x-request-id.

Kuchengeta key yakachengeteka

• Chengeta key pa-server. Usaiise mu-web pages, mobile apps kana public repositories: ani naani anayo anogona kushandisa balance yako yese.
• Tora key kubva ku-environment variable kana secret store panzvimbo pekuinyora mu-code.
• Kana key ingave yakaburitswa, ichinje pa-Keys & usage. Key yekare inomira kushanda pakarepo.
• Mushure mekuburitswa kwe-key, verenga request list pa-Keys & usage. Inoratidza request imwe neimwe yakaitwa ne-key mumazuva 30 apfuura.