メインコンテンツまでスキップ

鍵 1 本、6 つの呼び出し、1,185 AP — AICU API の全部を一度に試す

· 約10分
AICU API Team
AICU API Team
api.aicu.ai

真鍮の鍵から 5 本の色の線が伸び、音の波形・絵筆・チェックボックス・吹き出し・フィルムのコマにつながっている挿絵

音声合成、画像生成、型のついた判断、そして OpenAI 互換のチャット。api.aicu.ai では、これらすべてが 鍵 1 本の向こうにあります。この記事では、それを順番に全部叩いて、そのとき実際に引かれた AP をそのまま載せます。価格表からの引き写しではなく、レスポンスヘッダ X-AICU-AP-Cost の値です。

記事全体の合計は 1,185 AP、およそ 0.12 USD でした。

明日、会場でお会いしましょう — 9 月 23 日（水・祝）、浜松町。 AICU Japan が 生成AIなんでも展示会 Vol.6 に出展します。ブースは A-7 ／ A-8、12:00〜17:30、東京都立産業貿易センター 浜松町館 5F。この記事の内容はその場で全部お見せできますし、ブースは 『国際AIクリエイターアワード2026』 のエントリー受付コーナーも兼ねています。どうぞ目の前で壊しにきてください。

まず鍵を 1 本​

api.aicu.ai/signup で登録し、api.aicu.ai/dashboard/keys で鍵を発行します。ベータ期間中は、新しいアカウントに 100,000 AP（約 10 USD） が入ります。この記事の内容を 80 回ぶん試せる量です。

AP は前払いで、月額の従量契約はありません。1 AP = 0.0001 USD。選ぶプランも、買う席数もありません。鍵が失効しても何も消えません。利用履歴も残高もそのまま、鍵が 401 を返すようになるだけです。

export AICU_API_KEY=aicu_...    # /dashboard/keys で発行した鍵

1. 日本語の読み上げ — 5 AP​

音声合成のエンドポイントは OpenAI の /audio/speech と同じボディを受け取ります。既存のクライアントは、ベース URL と鍵を差し替えるだけで動くことがほとんどです。

curl -X POST https://api.aicu.ai/v1/audio/speech \
  -H "Authorization: Bearer $AICU_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"input": "展示会でお会いできるのを楽しみにしています。", "voice": "elena"}' \
  --output hello.mp3

日本語 22 文字、3.4 秒の音声で 5 AP。既定のモデルは eleven_multilingual_v2 です。

voice にはキャラクターの slug を渡します（GET /v1/tts/voices に鍵を付けて叩くと、使えるボイスの一覧が返ります）。お気に入りの ElevenLabs のボイス ID をそのまま渡すこともできます。

2. 同じ文をもう一度 — 0 AP​

まったく同じリクエストを 2 回目に投げると、返ってくる音声はバイト単位で同じ、待ち時間はほぼゼロ、そして 無料です。

x-aicu-ap-cost: 0

音声はボイス・モデル・シード・本文そのもので照合してキャッシュしています。これは思ったより効きます。視聴者全員に同じ挨拶をする AITuber、同じ掛け声を繰り返すゲーム、イントロをループする什器 — どれも料金がかかるのは最初の 1 回だけです。

ゼロ円の行が「課金の不具合」に見えないよう、利用履歴 ではキャッシュヒットを明示しています。失敗したリクエストも課金しません（予約した AP は全額戻します）。

3. eleven_v3 と、本文の中での演技指示 — 7 AP​

model を渡すと切り替わります。eleven_v3 は本文中のオーディオタグを読むので、ぴったりのボイスを探しまわる代わりに、文章の中で演技を指示できます。

curl -X POST https://api.aicu.ai/v1/audio/speech \
  -H "Authorization: Bearer $AICU_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"input": "[excited]展示会でお会いできるのを楽しみにしています。",
       "voice": "elena", "model": "eleven_v3"}' \
  --output hello-v3.mp3

7 AP。同じ文、違う芝居です。聴き比べてみてください。

設計上の決め事をひとつ。知らない model 値は 400 を返します。黙って v2 に落としません。頼んでいない 200 は、エラーより厄介だからです。

4. 画像を 1 枚 — 1,170 AP​

この記事の冒頭の挿絵は、この API から出てきたものです。実際の呼び出しがこちらです。

curl -X POST https://api.aicu.ai/v1/images/generations \
  -H "Authorization: Bearer $AICU_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model": "nano-banana", "size": "1536x1024", "n": 1,
       "prompt": "A single ornate brass key lying on warm cream paper, drawn as a clean editorial line illustration with soft watercolour shading. From the teeth of the key, five slender coloured threads fan out to the right and each ends in one small hand-drawn glyph: a sound wave, a paintbrush, a ticked checkbox, a speech bubble, and a film frame. Muted palette: brass, dusty rose, sage green, ochre, slate blue, terracotta. Generous empty space on the left. No text, no letters, no numbers, no logos, no watermark."}'

1,170 AP、10.4 秒、b64_json で返ります。ボディは OpenAI と同形なので、openai.images.generate() がそのまま通ります。品質を段階で選びたいときは、同じエンドポイントで gpt-image-2.5 も使えます（GPT-Image-2.5 の記事 で別途測っています）。

領収書の記事なので正直に書いておくと、この挿絵は 1 回ボツにしていて、そのぶんの 1,170 AP も払っています。画像生成は試行の数だけかかりますし、それは履歴にそのまま出ます。

5. 型のついた判断 — 2 AP​

いちばん知られていないのがこのエンドポイントです。チャットモデルは文章で答えるので、アプリ側は毎回その文章を解析して分岐に戻す必要があります。/v1/jev は TypeSafe AI の Jev を中継して、型で答えます。選択（choice）・段階（score）・確からしさ（noul）の 3 つです。

実際のお問い合わせを 1 件、そのまま入れてみます。

curl -X POST https://api.aicu.ai/v1/jev \
  -H "Authorization: Bearer $AICU_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "state": "Customer wrote: The mp3 was generated but my credit balance did not go down. Is something broken?",
    "questions": {
      "intent": { "type": "choice", "instructions": "What is this message mainly about?",
        "criteria": { "billing": "About charges, credits or the balance",
                      "bug_report": "Something appears to be broken",
                      "feature_request": "Asking for something new",
                      "praise": "Positive feedback with no question" } },
      "urgency": { "type": "score", "instructions": "How urgent is this for the customer?",
        "criteria": ["no rush", "answer this week", "answer today", "service is down"] },
      "needs_human": { "type": "noul", "instructions": "How likely is it that a human must reply?" }
    }
  }'

返ってきた答え（抜粋）:

{
  "model": "jev-1.13.0",
  "answers": {
    "intent":      { "choice": "billing", "probabilities": { "billing": 0.78, "bug_report": 0.22 }, "confidence": 0.71 },
    "urgency":     { "score": 1.68, "legend": { "0": "no rush", "1": "answer this week", "2": "answer today", "3": "service is down" }, "confidence": 0.63 },
    "needs_human": { "noul": 0.68 }
  },
  "ap_cost": 2
}

確率つきの答えが 3 つで 2 AP。正規表現も、「JSON で返してください」というお願いも、モデルが喋りすぎたときのリトライも要りません。answers.intent.choice で分岐すれば終わりです。

（この例は作り話ではありません。実際にいただいたお問い合わせに近い文面で、そして §2 のキャッシュヒットが、その答えでした。）

6. OpenAI 互換のチャット — 1 AP​

curl -X POST https://api.aicu.ai/v1/chat/completions \
  -H "Authorization: Bearer $AICU_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model": "deepseek-v3",
       "messages": [{"role": "user", "content": "Reply in one short sentence: what is an API key for?"}]}'

An API key is used to authenticate and authorize access to an API.

31 トークン、2.1 秒、1 AP。OpenAI の SDK なら 2 行です。

from openai import OpenAI
client = OpenAI(base_url="https://api.aicu.ai/v1", api_key=os.environ["AICU_API_KEY"])

いま通るモデルは GET /v1/chat/models で一覧できます。api.aicu.ai/models は同じ一覧に価格を添えたものです。

お会計​

この記事の 6 つの呼び出しの明細: 5 AP、0 AP、7 AP、1,170 AP、2 AP、1 AP、合計 1,185 AP

課金されるリクエストには、必ず 2 つのヘッダが返ります。

ヘッダ意味
X-AICU-AP-Costこのリクエストにかかった AP（キャッシュヒットなら 0）
X-AICU-AP-Balance引いたあとの残高

前者をログに残しておけば、請求書を待たずに自分でコスト計算ができます。同じ内容はエンドポイントごとに 利用履歴 にも並びます。

円建てでのお支払いについて​

USD でのお支払いは、どなたでも問題ありません。個人の方も、個人事業主の方も、まず試してみたいチームも同じです。

円建てパックは用途がもう少し限られていて、適格請求書（インボイス）・銀行振込・年度予算での購入が必要な日本の法人向けのものです。こちらは AICU Japan 株式会社（法人向け・円建・適格事業者） が販売し、換算レートは実勢に対して毎週見直して公表しています。9 月 30 日から、円建てパックは 1 USD = 180 円換算に改定されます。USD 建ての価格は変わりません。

この先の予定​

ベータの日程です（いずれも 09:00 JST）。

日付
10/7AP パックの購入を USD で開始。全アカウントに本番のご案内をメールします
10/14ベータ鍵の新規発行を終了。以降に発行する鍵は本番の aicu_live_ 鍵です
10/21本番運用を開始。新規の鍵はカード登録が前提になります
10/31ベータ鍵が失効します

失効しても何も消えませんし、鍵が切れる 1 週間前には所有者の方へメールでお知らせします。

それまではベータが開いています。ご自分のプロジェクトに合うかどうかを確かめるいちばん早い方法は、12 セントぶんだけ使ってみることです。

この記事の AP はすべて 2026 年 9 月 22 日に本番環境で実測した値です。ご自分の鍵で再現すれば、同じ数字になるはずです。