cicora.ai
Magyar
API-specifikációMessages formátum

Messages API

A Messages formátumot használja a legfelső szintű rendszerutasítást és kifejezett kimeneti korlátot tartalmazó beszélgetésekhez.

Integrációs referencia: válassza ki a paramétereket és az elérhető képességeket a fiókja API-beállításaiból és a környezetéhez tartozó modellkatalógusból.

Üzenet összeállítása

A kérés model, messages és max_tokens mezőt tartalmaz; a rendszerutasítás külön system mezőbe kerül. Őrizze meg a szerepeket és az üzenetsorrendet, hogy az újrapróbálkozás reprodukálhassa a kontextust.

Nyers HTTP esetén a hívott cím https://cicora.ai/api/v1/messages, míg a Messages SDK csak a https://cicora.ai/api átjárógyökeret kapja meg, és maga fűzi hozzá a /v1/messages útvonalat.

Messages API-kérés
bash
curl --request POST https://cicora.ai/api/v1/messages \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 500,
    "system": "Answer with a compact checklist.",
    "messages": [{"role": "user", "content": "Prepare a release plan."}]
  }'

Eszközök és streamelés

  • A tools és tool_choice mezőt csak az ezeket támogató modellekhez adja hozzá.
  • A streamelő módot eseménysorozatként kezelje, ne egyetlen JSON-objektumként.
  • Művelet végrehajtása előtt ellenőrizze az eszközargumentumok alakját.

Formátum választása

Ne keverje két formátum mezőit egy kérésben. A klienshatáron válassza a chat vagy messages formátumot, és a belső előzményt egyszer normalizálja.

Az áttelepítést mentett, személyazonosításra alkalmatlanná tett beszélgetéssel tesztelje, eszközeredménnyel és hosszú kontextussal együtt.

Olvasson tovább