1. 環境を準備する
キーは環境変数またはシークレットストアにだけ保持します。ブラウザーコードにキーを含めたり、ログへ書き込んだりしてはなりません。
連携用ベースURLは次のとおりです：https://cicora.ai/api/v1. 以下の各例では、そのベースにルートを追加します。
最初のリクエスト
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. リクエストを構成する
- カタログから返された正確なモデル識別子を使用します。
- system、user、assistant、必要に応じてtoolという会話順でメッセージを送信します。
- まずばらつきを低く設定し、その後タスクに合わせてパラメーターを調整します。
3. 応答を処理する
最初に利用可能な応答項目からテキストを読み取り、自社のトレースIDとともにリクエストIDを保存します。
再試行の前にステータスとエラー構造を確認します。アプリケーション側で処理の重複を防止できる操作だけを再試行してください。