Forbhreathnú

Críochphointí

Tá gach críochphointe faoi URL bonn amháin agus seirbheáiltear thar HTTPS é.

https://api.shannon-ai.com

Sroicheann na trí chríochphointe a tháirgeann téacs na múnlaí céanna. Roghnaigh an ceann a n-úsáideann do chód a fhormáid cheana.

Bunghnéithe iarratais

• Is réad JSON amháin é corp gach POST, suas le 32 MiB.
• Ní chruthaíonn réimse nach bhfuil aithne ag an API air aon earráid agus níl aon éifeacht aige. Ní theipeann ar iarratas a scríobhadh do sholáthraí eile mar gheall ar réimse breise.
• Freagraítear réimse aitheanta le cineál JSON mícheart, nó réimse riachtanach ar iarraidh, le 422. Freagraítear corp nach JSON bailí é le 400.
• Is ceann de na hids ar Mhúnlaí agus praghsáil é model. Is cuma litreacha móra nó beaga.

Is JSON é freagra, nó sruth imeachtaí a sheoltar ón bhfreastalaí nuair a shocraíonn an t-iarratas stream go true. Freagraíonn gach críochphointe ina fhormáid féin. Tá an ceanntásc x-request-id ar gach freagra.

An rud a théann iarratas tríd

Seiceáiltear iarratas in ord seasta sula ritheann múnla. Freagraíonn an chéad seiceáil a theipeann, mar sin ní insíonn 401 aon rud duit faoin gcorp go fóill.

Cruth na n-earráidí

Is réad JSON é earráid le error a bhfuil type agus message ann. Fillteann /v1/messages í mar a bhíonn súil ag SDKanna Anthropic leis; úsáideann gach cosán eile cruth OpenAI.

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

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

• Léigh type agus message. Tá code agus param ar roinnt earráidí amháin: caith leo mar roghnach. Is null i gcónaí é param.
• Tar éis do shruth tosú, is 200 an stádas cheana. Tagann teip ansin mar fhráma earráide laistigh den sruth.
• Iompraíonn gach freagra earráide an ceanntásc x-request-id.

Láimhseáil Earráide

Billeáil agus iarmhéid

• Tá iarmhéid amháin ann in aghaidh an chuntais, agus roinneann comhrá agus API é: liúntas an phlean don lá inniu ar dtús, ansin creidmheas ceannaithe. Níl cuóta dá chuid féin ag an API.
• Cuireann iarratas a bhuiséad aschuir (max_tokens, réamhshocrú 4,096) in áirithe agus ansin muirearaítear air na token a d'úsáid sé i ndáiríre, ar phraghas an mhúnla.
• Tuairiscíonn gach freagra a chomhaireamh token in usage. Taispeánann an leathanach Eochracha agus úsáid an t-iarmhéid agus cad a chosain gach iarratas.
• Freastalaítear ar gach iarratas ar an gcaoi chéanna. Is é cosaint tuile an t-aon teorainn ar ráta iarratas: 120 iarratas in aghaidh an nóiméid in aghaidh an chuntais. Fanann iarratais a sheoltar comhthreomhar sa scuaine.

Teorainneacha agus iarmhéid Múnlaí agus praghsáil Eochracha agus úsáid

Réimsí a bhraitheann ar an múnla

Glacann gach múnla leis an iarratas céanna. Tagann cúpla réimse i bhfeidhm ar roinnt múnlaí amháin; ainmníonn an tábla cá háit. Liostaíonn leathanaigh na gcríochphointí gach réimse.

Chat Completions

Ag teacht ó SDK de chuid OpenAI

• Socraigh an URL bonn go https://api.shannon-ai.com/v1 agus an eochair go d'eochair Shannon. Ansin oibríonn glaonna Chat Completions agus Responses leis an SDK mar atá.
• Caithfidh model a bheith ina id Shannon. Freagraítear ainm múnla soláthraí eile, mar gpt-4o, le 400 agus unknown model.
• Tagann réasúnaíocht i réimse dá cuid féin: reasoning_content in aice le content, sa teachtaireacht agus i deltaí an tsrutha.
• Iompraíonn sruth usage ina phíosa deireanach i gcónaí, in éineacht le finish_reason.
• Tagann glao uirlise i sruth mar phíosa amháin leis an tsreang arguments iomlán.
• Tá rogha amháin i bhfreagra.
• Freagraítear cosáin den API OpenAI nach bhfuil sa tábla thuas, mar /v1/embeddings, le 404.

Ag teacht ó SDK Anthropic

• Socraigh an URL bonn go https://api.shannon-ai.com, gan /v1, agus an eochair go d'eochair Shannon. Seolann an SDK mar x-api-key í.
• Caithfidh model a bheith ina id Shannon.
• Tá max_tokens roghnach ar an API seo. Is é 4,096 a réamhshocrú.
• Tá bloic ábhair den chineál thinking, text agus tool_use i bhfreagra. Ní hé an téacs an chéad bhloc i gcónaí: roghnaigh bloic de réir type.
• Is é stop_reason end_turn nó tool_use. Is féidir le sruth de mhúnla Shannon deireadh le max_tokens freisin.
• Glactar le anthropic-version agus anthropic-beta, mar sin oibríonn an SDK gan athrú. Ní theastaíonn siad ó iarratas.
• Tá cruth Anthropic ar earráidí ar /v1/messages: {"type": "error", "error": {…}}.

Socraítear uirlisí códaithe a labhraíonn na formáidí seo ar an mbealach céanna: URL bonn, eochair, agus id Shannon mar an múnla. Uirlisí CLI códaithe