cicora.ai
Polski
Specyfikacja APIStart

Szybki start

Wyślij pierwsze żądanie, wybierz model z katalogu i zachowaj identyfikator żądania do diagnostyki.

SDK w stylu OpenAI i curlhttps://cicora.ai/api/v1
SDK Messages i Claude Codehttps://cicora.ai/api

Materiały dotyczące integracji: wybierz parametry i dostępne funkcje w ustawieniach API konta oraz w katalogu modeli dla swojego środowiska.

1. Przygotuj środowisko

Przechowuj klucz wyłącznie w zmiennej środowiskowej lub magazynie sekretów. Kod przeglądarki nie może go zawierać ani zapisywać w dziennikach.

Bazowy adres URL integracji to https://cicora.ai/api/v1. Każdy poniższy przykład dodaje swoją ścieżkę do tej bazy.

Pierwsze żądanie
bash
export CICORA_API_KEY=replace_with_your_key

curl --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "messages": [{"role": "user", "content": "Explain this API in one sentence."}]
  }'

2. Utwórz żądanie

  • Użyj dokładnego identyfikatora modelu zwróconego przez katalog.
  • Wysyłaj wiadomości w kolejności rozmowy: system, user, assistant i w razie potrzeby tool.
  • Zacznij od mniejszej zmienności, a następnie dostosuj parametry do zadania.

3. Obsłuż odpowiedź

Odczytaj tekst z pierwszego dostępnego elementu odpowiedzi i zapisz identyfikator żądania razem z własnym identyfikatorem śladu.

Przed ponowieniem sprawdź status i strukturę błędu. Ponawiaj tylko te operacje, w przypadku których aplikacja może zapobiec powieleniu pracy.

Czytaj dalej