クイックスタート

サインイン → 接続トークン → 最初の呼び出し。5 分。レッドチームのモデルにはカード本人確認が要ります（無料枠 1,000 件/日はそのまま）。

1. サインインしてトークンを発行

kotoba.cloud/account にパスキーかウォレットでサインインし、「CLI / IDE から使う」→「接続トークンを発行」。一度だけ表示されます。

Shell

export KOTOBA_API_TOKEN="kc_pat_<your-token>"
curl -s https://api.kotoba.cloud/v1/models -H "Authorization: Bearer $KOTOBA_API_TOKEN"

2. 本人確認（レッドチームのモデルに必要）

アカウントコンソールの「本人確認」でクレジットまたはデビットカードを登録すると、数秒で code-review スコープが承認されます。ブルーチームのモデルはこの段階を飛ばせます。

Shell

curl -s https://api.kotoba.cloud/v1/research/status -H "Authorization: Bearer $KOTOBA_API_TOKEN"
# → {"status": "eligible", "freeTier": {...}, "scopes": [{"id": "owned", "status": "approved", "tasks": ["code-review"]}]}

3. 最初の呼び出し

curl

curl -s -X POST https://api.kotoba.cloud/v1/chat/completions \
  -H "Authorization: Bearer $KOTOBA_API_TOKEN" -H "content-type: application/json" \
  -d '{"model":"qwen3.8-flash-next-whitehacker","max_tokens":2048,
       "messages":[{"role":"user","content":"Review this login handler for auth bypasses: ..."}]}'

Python

from openai import OpenAI
client = OpenAI(base_url="https://api.kotoba.cloud/v1", api_key=os.environ["KOTOBA_API_TOKEN"])
r = client.chat.completions.create(model="qwen3.8-flash-next-whitehacker", max_tokens=2048,
    messages=[{"role": "user", "content": "Review this login handler for auth bypasses: ..."}])
print(r.choices[0].message.content)

応答は OpenAI の chat.completion に billing（"free" / "paid"）と receiptId が付いた形です。初回は origin の起動で数十秒〜数分かかることがあります。

4. 次に

エージェント・IDE をつなぐ（Claude Code、Codex CLI、Cursor、hermes…）
ツール呼び出し · ストリーミング · Reasoning
エンドポイント一覧 · CLI 早見表
credits を足す（無料枠を超えて使うとき）

未確認の principal がレッドチームのモデルを呼ぶと 403 verification-required（本人確認前）または research-scope-required（スコープ未承認）です。ジョブ API（submit → poll）は Streaming の頁に。