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 zahteva

• Telo svakog POST je jedan JSON objekat, do 32 MiB.
• Polje koje API ne poznaje ne izaziva grešku i nema efekta. Zahtev napisan za drugog provajdera ne ruši se zbog viška polja.
• Na poznato polje sa pogrešnim JSON tipom, ili obavezno polje koje nedostaje, odgovara se sa 422. Na telo koje nije važeći JSON odgovara se sa 400.
• model je jedan od id-jeva na stranici Modeli i cene. Velika i mala slova nisu važna.

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

Šta zahtev prolazi

Zahtev se proverava fiksnim redom pre nego što model počne. Odgovara prva provera koja ne uspe, pa vam 401 još ništa ne govori o telu.

Oblik greške

Greška je JSON objekat sa error koji sadrži type i message. /v1/messages ga pakuje 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 na nekim greškama: tretirajte ih kao opcione. param je uvek null.
• Nakon što stream počne, status je već 200. Greška tada stiže kao frame greške unutar streama.
• Svaki odgovor sa greškom nosi zaglavlje x-request-id.

Upravljanje greškama

Naplata i stanje

• Postoji jedno stanje po nalogu, a čet i API ga dele: prvo današnji limit plana, zatim kupljeni kredit. API nema sopstvenu kvotu.
• Zahtev rezerviše svoj izlazni budžet (max_tokens, podrazumevano 4,096), a zatim se naplaćuje za tokene koje je zaista iskoristio, po ceni modela.
• Svaki odgovor prijavljuje svoje brojeve tokena u usage. Stranica Ključevi i upotreba prikazuje stanje i koliko je koštao svaki zahtev.
• Svaki zahtev se opslužuje jednako. Jedino ograničenje brzine zahteva je zaštita od flooda: 120 zahteva u minuti po nalogu. Zahtevi poslati paralelno čekaju u redu.

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

Polja koja zavise od modela

Svaki model prima isti zahtev. Nekoliko polja ima efekat samo na nekim modelima; tabela navodi gde. 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 takvim kakav jeste.
• model mora biti Shannon id. Na ime modela drugog provajdera, kao što je gpt-4o, odgovara se sa 400 i unknown model.
• Rezonovanje dolazi u posebnom polju: reasoning_content pored content, u poruci i u delta-ma streama.
• Stream uvek nosi usage u svom poslednjem delu, zajedno sa finish_reason.
• Poziv alata u streamu stiže kao jedan deo sa kompletnim stringom arguments.
• Odgovor ima jedan izbor.
• Putanje OpenAI API-ja koje nisu u tabeli iznad, kao što je /v1/embeddings, dobijaju odgovor 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 opcioni na ovom API-ju. Podrazumevano je 4,096.
• Odgovor sadrži blokove sadržaja tipa thinking, text i tool_use. Prvi blok nije uvek tekst: birajte blokove po type.
• stop_reason je end_turn ili tool_use. Stream Shannon modela može se završiti i sa max_tokens.
• anthropic-version i anthropic-beta se prihvataju, pa SDK radi nepromenjen. Zahtev ih ne treba.
• Greške na /v1/messages imaju Anthropic oblik: {"type": "error", "error": {…}}.

Alati za programiranje koji govore ove formate podešavaju se isto: osnovni URL, ključ i Shannon id kao model. CLI alati za programiranje