cicora.ai
API спецификациясыMessages пішімі

Messages API

Жоғарғы деңгейдегі жүйелік нұсқауы және нақты шығыс шегі бар сөйлесулер үшін Messages пішімін пайдаланыңыз.

Интеграция анықтамалығы: параметрлер мен қолжетімді мүмкіндіктерді тіркелгіңіздің API параметрлерінен және ортаңызға арналған модельдер каталогынан таңдаңыз.

Хабар құрастыру

Сұрау model, messages және max_tokens өрістерін қамтиды; жүйелік нұсқау бөлек system өрісінде жіберіледі. Қайталанған сұрау контексті қайта жасай алуы үшін рөлдер мен хабарлар ретін сақтаңыз.

Өңделмеген HTTP сұраулары мына мекенжайға жіберіледі: https://cicora.ai/api/v1/messages, ал Messages SDK тек https://cicora.ai/api шлюз түбірін қабылдап, /v1/messages жолын өзі қосады.

Messages API сұрауы
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."}]
  }'

Құралдар және ағынмен жіберу

  • tools және tool_choice өрістерін оларды қолдайтын модельдерге ғана қосыңыз.
  • Ағындық режимді бір JSON нысаны ретінде емес, оқиғалар тізбегі ретінде өңдеңіз.
  • Әрекет жасамас бұрын құрал аргументтерінің пішінін растаңыз.

Пішім таңдау

Бір сұрауда екі пішімнің өрістерін араластырмаңыз. Клиент шекарасында chat немесе messages пішімін таңдап, ішкі тарихты бір рет қалыпқа келтіріңіз.

Тасымалдауды құрал нәтижесі мен ұзақ контексті қамтитын, сәйкестендіретін деректері жойылған сақталған сөйлесумен тексеріңіз.