Pregled

Endpointi

Svaki endpoint nalazi se pod jednim osnovnim URL-om i opslužuje se preko HTTPS-a.

https://api.shannon-ai.com

Tri endpointa koja proizvode tekst dosežu iste modele. Izaberite onaj čiji format vaš kod već koristi.

Osnove zahtjeva

• Tijelo svakog POST-a je jedan JSON objekat, do 32 MiB.
• Polje koje API ne poznaje ne uzrokuje grešku i nema učinka. Zahtjev napisan za drugog provajdera ne propada zbog viška polja.
• Na poznato polje s pogrešnim JSON tipom, ili na nedostajuće obavezno polje, odgovara se sa 422. Na tijelo koje nije valjan JSON odgovara se sa 400.
• model je jedan od id-ova na stranici Modeli i cijene. Velika i mala slova nisu bitna.

Odgovor je JSON, ili stream server-sent events kada zahtjev postavi stream na true. Svaki endpoint odgovara u svom formatu. Svaki odgovor ima zaglavlje x-request-id.

Šta zahtjev prolazi

Zahtjev se provjerava utvrđenim redoslijedom prije nego što se model pokrene. Odgovara prva provjera koja ne uspije, pa vam 401 još ništa ne govori o tijelu.

Oblik greške

Greška je JSON objekat s error koji sadrži type i message. /v1/messages ga umotava onako kako Anthropic SDK-ovi očekuju; svaka druga putanja koristi OpenAI oblik.

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

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

• Čitajte type i message. code i param postoje samo kod nekih grešaka: tretirajte ih kao opcionalne. param je uvijek null.
• Nakon što je stream počeo, status je već 200. Greška tada stiže kao error frame unutar streama.
• Svaki odgovor s greškom nosi zaglavlje x-request-id.

Upravljanje greškama

Naplata i stanje

• Postoji jedno stanje po računu, a chat i API ga dijele: prvo današnja dnevna kvota plana, zatim kupljeni kredit. API nema vlastitu kvotu.
• Zahtjev rezerviše svoj izlazni budžet (max_tokens, zadano 4,096), a zatim se naplaćuje za tokene koje je zaista iskoristio, po cijeni modela.
• Svaki odgovor prijavljuje broj svojih tokena u usage. Stranica Ključevi i korištenje prikazuje stanje i koliko je koštao svaki zahtjev.
• Svaki zahtjev se opslužuje jednako. Jedino ograničenje brzine zahtjeva je flood zaštita: 120 zahtjeva u minuti po računu. Zahtjevi poslani paralelno čekaju u redu.

Ograničenja i stanje Modeli i cijene Ključevi i korištenje

Polja koja ovise o modelu

Svaki model prima isti zahtjev. Nekoliko polja djeluje samo na nekim modelima; tabela navodi gdje. Stranice endpointa navode svako polje.

Chat Completions

Dolazite iz OpenAI SDK-a

• Postavite osnovni URL na https://api.shannon-ai.com/v1, a ključ na svoj Shannon ključ. Pozivi Chat Completions i Responses tada rade sa SDK-om bez izmjena.
• model mora biti Shannon id. Na ime modela drugog provajdera, kao što je gpt-4o, odgovara se sa 400 i unknown model.
• Razmišljanje dolazi u zasebnom polju: reasoning_content pored content, u poruci i u delta objektima streama.
• Stream uvijek nosi usage u svom posljednjem chunku, zajedno s finish_reason.
• Poziv alata u streamu stiže kao jedan chunk s kompletnim stringom arguments.
• Odgovor ima jedan izbor.
• Na putanje OpenAI API-ja koje nisu u tabeli iznad, kao što je /v1/embeddings, odgovara se sa 404.

Dolazite iz Anthropic SDK-a

• Postavite osnovni URL na https://api.shannon-ai.com, bez /v1, a ključ na svoj Shannon ključ. SDK ga šalje kao x-api-key.
• model mora biti Shannon id.
• max_tokens je u ovom API-ju opcionalan. Zadano je 4,096.
• Odgovor sadrži blokove sadržaja tipa thinking, text i tool_use. Prvi blok nije uvijek tekst: blokove birajte po type.
• stop_reason je end_turn ili tool_use. Stream Shannon modela može završiti i s max_tokens.
• anthropic-version i anthropic-beta se prihvataju, pa SDK radi neizmijenjen. Zahtjev ih ne treba.
• Greške na /v1/messages imaju Anthropic oblik: {"type": "error", "error": {…}}.

Alati za kodiranje koji govore ove formate postavljaju se na isti način: osnovni URL, ključ i Shannon id kao model. CLI alati za kodiranje