cicora.ai
API仕様組織

チームとAPIキー

アプリケーションやワークスペースごとに、キー、所有者、予算、利用記録を分けます。

連携リファレンス:お使いの環境に合わせて、アカウントのAPI設定とモデルカタログからパラメーターおよび利用可能な機能を選択してください。

所有権モデル

連携ごとにキーを発行し、所有者、環境、失効時の連絡先を割り当てます。これにより、キーに関するインシデントが発生しても、チーム全体を停止せず対象を絞って対処できます。

新しいキーをキュー、Webhook、ユーザーインターフェースに接続する前に、モデルカタログを使って確認します。

推論を実行せずに発行済みキーを確認
bash
curl --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

支出管理

  • キー上限はガードレールとして使用し、コストの見積もりには使用しないでください。
  • 内部プロジェクトをキーおよびリクエストIDに関連付けます。
  • 所有者の確認後、未使用のキーを定期的に削除します。

ばらつきを調査

モデル、ワークフロー、キー、期間別に利用量を比較します。コンテキストのない支出合計だけでは、原因をすばやく特定できません。

必要な識別子だけを保持し、支出情報へのアクセスはリンクの利便性ではなく役割に基づいて付与します。