Pregled

Endpointi

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

https://api.shannon-ai.com

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

Osnove zahtjeva

• Tijelo svakog POST zahtjeva je jedan JSON objekt, do 32 MiB.
• Polje koje API ne poznaje ne uzrokuje grešku i nema učinka. Zahtjev napisan za drugog pružatelja ne uspijeva zbog dodatnog polja.
• Na poznato polje s pogrešnim JSON tipom ili na izostavljeno obavezno polje odgovara se s 422. Na tijelo koje nije valjani JSON odgovara se s 400.
• model je jedan od id-ova na stranici Modeli i cijene. Velika i mala slova nisu važna.

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

Što zahtjev prolazi

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

Oblik greške

Greška je JSON objekt s poljem error koje sadrži type i message. /v1/messages ga umata 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 prisutni su samo kod nekih grešaka: tretirajte ih kao neobavezne. param je uvijek null.
• Nakon što stream počne, status je već 200. Greška tada stiže kao okvir greške 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šnji dopušteni iznos plana, zatim kupljeni kredit. API nema vlastitu kvotu.
• Zahtjev rezervira svoj izlazni proračun (max_tokens, zadano 4,096), a zatim se naplaćuje za tokene koje je stvarno iskoristio, po cijeni modela.
• Svaki odgovor prijavljuje svoje brojeve tokena u usage. Stranica Ključevi i upotreba prikazuje stanje i koliko je koštao svaki zahtjev.
• Svaki zahtjev se poslužuje jednako. Jedino ograničenje učestalosti zahtjeva je flood protection: 120 zahtjeva u minuti po računu. Zahtjevi poslani paralelno čekaju u redu.

Ograničenja i stanje Modeli i cijene Ključevi i upotreba

Polja koja ovise o modelu

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

Chat Completions

Dolazite iz OpenAI SDK-a

• Postavite base 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 naziv modela drugog pružatelja, poput gpt-4o, odgovara se s 400 i unknown model.
• Razmišljanje dolazi u zasebnom polju: reasoning_content pokraj content, u poruci i u delta zapisima streama.
• Stream uvijek nosi usage u svom zadnjem chunku, zajedno s finish_reason.
• Poziv alata u streamu stiže kao jedan chunk s potpunim nizom arguments.
• Odgovor ima jedan izbor.
• Na putanje OpenAI API-ja kojih nema u gornjoj tablici, poput /v1/embeddings, odgovara se s 404.

Dolazite iz Anthropic SDK-a

• Postavite base 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 na ovom API-ju neobavezan. Zadana vrijednost je 4,096.
• Odgovor sadrži blokove sadržaja tipa thinking, text i tool_use. Prvi blok nije uvijek tekst: blokove birajte prema 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 prihvaćaju, pa SDK radi nepromijenjen. Zahtjev ih ne treba.
• Greške na /v1/messages imaju Anthropic oblik: {"type": "error", "error": {…}}.

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