使い方

届いたAPIキーを Authorization: Bearer ヘッダーに入れて呼び出します。使うAIのモデルは、購入した性能で決まります。

AIに質問する（1回分を消費）

curl -X POST https://api.aiapiticket.com/v1/chat \
  -H "Authorization: Bearer aat_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "system": "あなたは丁寧な日本語で答えるアシスタントです。",
    "messages": [
      { "role": "user", "content": "回数券の良いところを3つ教えて" }
    ]
  }'

messages には会話を順番に入れます。role は user か assistantで、最初と最後は user にしてください。system は省略できます。

応答の例

{
  "id": "6f1c…",
  "tier": "mid",
  "model": "claude-sonnet-5",
  "content": "1. 必要な分だけ買える …",
  "truncated": false,
  "usage": { "input_tokens": 42, "output_tokens": 180 },
  "remaining": 24
}

remaining は、この呼び出しの後の残り回数です。
truncated が true の場合、出力が1回の上限に達して途中で止まっています。

残り回数を確認する（消費しない）

curl https://api.aiapiticket.com/v1/balance \
  -H "Authorization: Bearer aat_live_xxxxxxxx"

1回の上限

1回の呼び出しで使える入力と出力の量には上限があります（性能ごとの上限は料金表に記載）。入力が上限を超えている場合は、回数を消費せずにエラーを返します。会話の履歴も入力に含まれるので、長い会話では古い部分を省いて送ってください。

エラー

HTTP	error.code	意味	回数
400	invalid_request	リクエストの形式が正しくない	消費しない
401	invalid_key	APIキーが正しくない	消費しない
402	no_credits	残り回数がない（追加で購入してください）	—
403	key_inactive	作り直し済みなどで、キーが無効	消費しない
413	input_too_long	入力が1回の上限を超えている	消費しない
422	refused	AIが回答を断った	消費しない
429	rate_limited	短時間に呼びすぎ（キーごとに毎秒1回まで）	消費しない
502 / 503	upstream_*	AIの提供元の障害・混雑	消費しない

エラーの本文は {"error":{"code":"…","message":"…"}} の形です。

キーの扱い

キーはサーバー側のプログラムでだけ使い、ブラウザやアプリの中に埋め込まないでください。
漏れた場合は、管理ページからすぐに作り直せます。残りの回数は引き継がれます。