Kakaretso

Li-endpoint

Endpoint e 'ngoe le e 'ngoe e ka tlase ho base URL e le 'ngoe mme e sebeletsoa ka HTTPS.

https://api.shannon-ai.com

Li-endpoint tse tharo tse hlahisang mongolo li fihla ho li-model tse tšoanang. Khetha eo sebopeho sa eona se seng se sebelisoang ke code ea hau.

Metheo ea kopo

• Body ea POST e 'ngoe le e 'ngoe ke ntho e le 'ngoe ea JSON, ho fihlela ho 32 MiB.
• Field eo API e sa e tsebeng ha e hlahise phoso mme ha e na phello. Kopo e ngotsoeng bakeng sa provider e mong ha e hloleha ka lebaka la field e eketsehileng.
• Field e tsejoang e nang le mofuta o fosahetseng oa JSON, kapa field e hlokahalang e sieo, e arajoa ka 422. Body eo e seng JSON e nepahetseng e arajoa ka 400.
• model ke e 'ngoe ea li-id tse leqepheng la Models & pricing. Litlhaku tse kholo le tse nyane ha li bohlokoa.

Karabo ke JSON, kapa stream ea server-sent events ha kopo e beha stream ho true. Endpoint e 'ngoe le e 'ngoe e araba ka sebopeho sa eona. Karabo e 'ngoe le e 'ngoe e na le header x-request-id.

Seo kopo e se fetang

Kopo e hlahlojoa ka tatellano e tsitsitseng pele model e sebetsa. Hlahlobo ea pele e hlolehang e a araba, kahoo 401 e ntse e sa u joetse letho ka body.

Sebopeho sa phoso

Phoso ke ntho ea JSON e nang le error e nang le type le message. /v1/messages e e koaletsa ka tsela eo li-SDK tsa Anthropic li e lebelletseng; tsela e 'ngoe le e 'ngoe e sebelisa sebopeho sa OpenAI.

{
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: gpt-4o"
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: gpt-4o"
  }
}

• Bala type le message. code le param li teng ho liphoso tse ling feela: li nke e le tse sa hlokahaleng. param kamehla ke null.
• Ka mor'a hore stream e qale, boemo bo se bo le 200. Ho hloleha ho ntan ho fihla e le frame ea phoso ka hare ho stream.
• Karabo e 'ngoe le e 'ngoe ea phoso e nka header x-request-id.

Diphoso

Billing le balance

• Ho na le balance e le 'ngoe ka akhaonte, mme chat le API li e arolelana: allowance ea plan ea kajeno pele, ebe credit e rekiloeng. API ha e na quota ea eona.
• Kopo e behela thoko output budget ea eona (max_tokens, default 4,096) mme ebe e lefisoa ka tokens tseo e li sebelisitseng ka 'nete, ka theko ea model.
• Karabo e 'ngoe le e 'ngoe e tlaleha palo ea tokens ho usage. Leqephe la Keys & usage le bontša balance le seo kopo e 'ngoe le e 'ngoe e se jeleng.
• Kopo e 'ngoe le e 'ngoe e sebeletsoa ka ho lekana. Moeli o le mong feela oa lebelo la likopo ke flood protection: likopo tse 120 ka motsotso ka akhaonte. Likopo tse romeloang ka parallel li ema moleng.

Meeli le balance Li-model le litheko Keys & usage

Li-field tse itšetlehileng ka model

Model e 'ngoe le e 'ngoe e amohela kopo e tšoanang. Li-field tse 'maloa li sebetsa ho li-model tse ling feela; tafole e re ke tse feng. Maqephe a li-endpoint a thathamisa field e 'ngoe le e 'ngoe.

Chat Completions

Ha u tsoa ho SDK ea OpenAI

• Beha base URL ho https://api.shannon-ai.com/v1 le senotlolo ho senotlolo sa hau sa Shannon. Likopo tsa Chat Completions le Responses li ntan li sebetsa le SDK joalo ka ha e le.
• model e tlameha ho ba id ea Shannon. Lebitso la model la provider e mong, le kang gpt-4o, le arajoa ka 400 le unknown model.
• Reasoning e tla ka field ea eona: reasoning_content haufi le content, molaetsing le ho li-delta tsa stream.
• Stream kamehla e nka usage chunk-ng ea eona ea ho qetela, hammoho le finish_reason.
• Kopo ea tool ho stream e fihla e le chunk e le 'ngoe e nang le string e feletseng ea arguments.
• Karabo e na le choice e le 'ngoe.
• Litsela tsa OpenAI API tseo li seng tafoleng e ka holimo, tse kang /v1/embeddings, li arajoa ka 404.

Ha u tsoa ho SDK ea Anthropic

• Beha base URL ho https://api.shannon-ai.com, ntle le /v1, le senotlolo ho senotlolo sa hau sa Shannon. SDK e se romela e le x-api-key.
• model e tlameha ho ba id ea Shannon.
• max_tokens ha e hlokahale ho API ena. Default ea eona ke 4,096.
• Karabo e na le li-content block tsa mofuta thinking, text le tool_use. Block ea pele hase kamehla mongolo: khetha li-block ka type.
• stop_reason ke end_turn kapa tool_use. Stream ea model ea Shannon e ka boela ea fela ka max_tokens.
• anthropic-version le anthropic-beta lia amohelwa, kahoo SDK e sebetsa ntle le phetoho. Kopo ha e li hloke.
• Liphoso ho /v1/messages li na le sebopeho sa Anthropic: {"type": "error", "error": {…}}.

Lisebelisoa tsa ho ngola code tse buang mebopeho ena li setupoa ka tsela e tšoanang: base URL, senotlolo, le id ea Shannon e le model. Lisebelisoa tsa CLI tsa ho ngola code