Chidule

Ma endpoint

Endpoint iliyonse ili pansi pa base URL imodzi ndipo imatumikiridwa pa HTTPS.

https://api.shannon-ai.com

Ma endpoint atatu opanga text amafika ku ma model omwewo. Sankhani yomwe mtundu wake code yanu imagwiritsa ntchito kale.

Zofunika za pempho

• Body ya POST iliyonse ndi JSON object imodzi, mpaka 32 MiB.
• Field yomwe API siidziwa siyimayambitsa cholakwika ndipo siigwira ntchito. Pempho lolembedwera wopereka wina silikulephera chifukwa cha field yowonjezera.
• Field yodziwika yokhala ndi JSON type yolakwika, kapena field yofunika yosowa, imayankhidwa ndi 422. Body yomwe si JSON yovomerezeka imayankhidwa ndi 400.
• model ndi imodzi mwa ma id a pa Models & pricing. Zilembo zazikulu ndi zazing'ono sizimakhudza.

Yankho ndi JSON, kapena stream ya server-sent events pamene pempho likhazikitsa stream kukhala true. Endpoint iliyonse imayankha mu mtundu wake. Yankho lililonse lili ndi header ya x-request-id.

Zomwe pempho limadutsa

Pempho limayang'aniridwa motsatira dongosolo lokhazikika model isanayende. Kuyang'ana koyamba kolephera ndiko kuyankha, choncho 401 sikukuuzani kanthu pa body.

Mawonekedwe a cholakwika

Cholakwika ndi JSON object yokhala ndi error yomwe ili ndi type ndi message. /v1/messages imaikulunga monga momwe ma Anthropic SDK amayembekezera; njira ina iliyonse imagwiritsa ntchito mawonekedwe a OpenAI.

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

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

• Werengani type ndi message. code ndi param zimakhalapo pa zolakwika zina zokha: zitengeni ngati zosafunika. param nthawi zonse ndi null.
• Stream ikayamba, status yakhala kale 200. Cholakwika chimafika ngati error frame mkati mwa stream.
• Yankho lililonse la cholakwika limanyamula header ya x-request-id.

Zolakwika

Malipiro ndi balance

• Pali balance imodzi pa akaunti, ndipo chat ndi API zimagawana: allowance ya plan ya lero poyamba, kenako credit yomwe munagula. API ilibe quota yake.
• Pempho limasunga output budget yake (max_tokens, default 4,096) ndipo kenako limaperekedwa mtengo wa ma token omwe lagwiritsa ntchito kwenikweni, pa mtengo wa model.
• Yankho lililonse limanena chiwerengero cha ma token ake mu usage. Tsamba la Keys & usage limaonetsa balance ndi zomwe pempho lililonse lawononga.
• Pempho lililonse limatumikiridwa mofanana. Malire okhawo a kuchuluka kwa ma pempho ndi flood protection: ma pempho 120 pa mphindi pa akaunti. Ma pempho otumizidwa nthawi imodzi amadikira pamzere.

Malire ndi balance Ma model ndi mitengo Keys & usage

Ma field omwe amadalira model

Model iliyonse imalandira pempho lomwelo. Ma field ochepa amagwira ntchito pa ma model ena okha; table imatchula komwe. Masamba a endpoint amalemba field iliyonse.

Chat Completions

Mukachokera ku OpenAI SDK

• Khazikitsani base URL kukhala https://api.shannon-ai.com/v1 ndi kiyi kukhala kiyi yanu ya Shannon. Ma call a Chat Completions ndi Responses amagwira ntchito ndi SDK monga ilili.
• model iyenera kukhala id ya Shannon. Dzina la model la wopereka wina, monga gpt-4o, limayankhidwa ndi 400 ndi unknown model.
• Reasoning imabwera mu field yake: reasoning_content pambali pa content, mu message ndi mu ma stream delta.
• Stream nthawi zonse imanyamula usage mu chunk yake yomaliza, pamodzi ndi finish_reason.
• Call ya tool mu stream imafika ngati chunk imodzi yokhala ndi string yathunthu ya arguments.
• Yankho lili ndi choice imodzi.
• Njira za OpenAI API zomwe sizili mu table yomwe ili pamwambapa, monga /v1/embeddings, zimayankhidwa ndi 404.

Mukachokera ku Anthropic SDK

• Khazikitsani base URL kukhala https://api.shannon-ai.com, popanda /v1, ndi kiyi kukhala kiyi yanu ya Shannon. SDK imaitumiza ngati x-api-key.
• model iyenera kukhala id ya Shannon.
• max_tokens ndi yosafunika pa API iyi. Default yake ndi 4,096.
• Yankho lili ndi content block za type thinking, text ndi tool_use. Block yoyamba si nthawi zonse text: sankhani ma block ndi type.
• stop_reason ndi end_turn kapena tool_use. Stream ya model ya Shannon ikhozanso kutha ndi max_tokens.
• anthropic-version ndi anthropic-beta zimalandiridwa, kotero SDK imagwira ntchito popanda kusintha. Pempho siliyenera kukhala nazo.
• Zolakwika pa /v1/messages zili ndi mawonekedwe a Anthropic: {"type": "error", "error": {…}}.

Ma tool a coding omwe amalankhula mitundu iyi amakhazikitsidwa chimodzimodzi: base URL, kiyi, ndi id ya Shannon ngati model. Zida za CLI zolembera code