CORELIVE

Platform & Account

アカウント、API キー、利用量、請求、アーキテクチャ、クライアント設定を一つの文書で確認します。

Scope
All products
Authentication
Bearer API key
Metering
Key / Product

01 / ACCOUNT & BILLING

Account & Billing

製品が増えても共通する、アカウント、キー、利用量、残高、請求の管理方法です。

プロフィール、ログイン方法、通知設定を管理します。共有認証情報ではなく、個人ごとのアカウントを利用してください。

API Keys

用途ごとにキーを発行し、サービスグループ、Quota、有効期限を設定します。明文は安全な Secret Store へ保存します。

Usage

期間、製品、API キーから利用記録を絞り込みます。実装や障害調査では request ID と時間帯を記録します。

Billing

残高、注文、契約状況をコンソールで確認します。正式な単価と決済条件は利用時点の表示を正とします。

02 / ARCHITECTURE

プラットフォーム構成

一つの入口で認証とポリシーを適用し、接続方式に合わせて各 API へルーティングします。

Request flow

  1. Authenticate

    API キー、失効状態、有効期限、サービスグループを確認します。

  2. Apply policy

    Rate limit と Quota を適用し、要求を受け付けるか判断します。

  3. Route

    接続方式とモデル指定に合わせて対象サービスへ送ります。

  4. Meter

    結果と利用量を記録し、コンソールの利用明細へ反映します。

Boundaries

責務の境界
LayerResponsibility
ClientSecret 管理、タイムアウト、再試行
Gateway認証、ポリシー、ルーティング、計測
Product APIモデル処理と製品固有の応答
Consoleキー、利用量、残高、請求の管理

Reliability

クライアントは timeout、再試行上限、idempotency の必要性を用途に合わせて設計し、request ID をログへ残します。

03 / CLIENT SETUP

クライアント設定

Base URL、認証、timeout、再試行を接続環境ごとに管理します。

Principles

  • API キーは環境変数または Secret Store から読む
  • 開発、CI、本番でキーを共有しない
  • timeout と再試行回数に上限を設ける
  • request ID と失敗理由を記録する

製品に合う接続方式を選ぶ

製品別の接続方式
ProductClient / protocolStart section
LLM Inference APIOpenAI-compatible Node.js / PythonLLM document · Quickstart
Codex APICoding agent / OpenAI-compatible APICodex document · Quickstart
Market Data APIHTTP client / curl / REST JSONMarket Data document · Quickstart

Node.js / LLM Inference API

JAVASCRIPT
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ARCANEFLUX_API_KEY,
  baseURL: "https://api.arcaneflux.com/v1"
});

Python / LLM Inference API

PYTHON
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ARCANEFLUX_API_KEY"],
    base_url="https://api.arcaneflux.com/v1"
)

Production checklist

  • Secret rotation の所有者と手順
  • timeout、再試行、同時実行数
  • Quota とアラートの閾値
  • request ID を含むログ
  • 障害時の切り戻し先

04 / SUPPORT

Service status

障害とメンテナンスは文書本文と切り離して確認します。

接続障害が疑われる場合は request ID と発生時刻を控えたうえで、ステータスページを確認してください。

Status を別タブで確認