ハッカソン: 鍵の受け取り方と使い方
AICU が協賛するハッカソンの参加者の方へ。鍵の受け取り方から使い方まで、このページに全部あります。URL 1 つで、Anthropic 以外のすべてのモデルを使えます。
鍵について
ハッカソンの鍵の受け取り方は 2 通りです。どちらを使うかは主催者から案内があります。
A. member.aicu.ai でバウチャーを引き換える（1 人 1 本）
- 主催者からの招待を開き、主催者が登録したメールアドレスで member.aicu.ai に登録します。AICU ID も同時にできます。
- 引き換えの画面で、主催者から受け取ったバウチャーのコードを入れます。
- AICU の利用規約とハッカソン・プログラム規約を読んで同意します。両方に同意しないと引き換えられません。
- 協賛クレジットとあなた専用の鍵が表示されます。鍵の値は一度しか表示されません。その場でコピーして、パスワード管理ツールか環境変数に保存してください。あとから再表示はできません。
- あとで ダッシュボード に同じ AICU ID でログインすると、ハッカソンの欄にクレジット・期限・鍵の名前・1 日の上限が出ます（鍵の値は出ません）。
カードの登録は要りません。引き換えは 1 人 1 回です。すでに AICU のクレジットを持っているアカウントでは引き換えられないので、ハッカソン用に新しいアカウントを使ってください（期限の違うクレジットを 1 つの残高に混ぜられないため）。
B. 主催者からチームの鍵を受け取る
チームに 1 本の鍵を使うイベントもあります。主催者（多くは先生やイベントの責任者）が受け取り、皆さんに渡します。アカウント作成やカード登録は要りません。
どちらの鍵も
- 値は
aicu_hack_で始まります。名前はAICU_Hack_<EVENT>_T<n>（例AICU_Hack_ANGERS_T1）の形で、個人の鍵には短い ID が付きます。 - 発行から最長 14 日で失効し、延長はしません。失効後の呼び出しは
401・code: "key_expired"を返します。 - 鍵は秘密にしてください。 環境変数に入れ、公開リポジトリ・Web ページ・配布するアプリには書かないでください。
aicu_hack_で始まる値は漏れたときに見つけやすくしてあります。漏れたとき・失くしたときは、すぐ api@aicu.ai へ連絡してください（主催者にも伝えてください）。止めて新しい鍵を出します。
export AICU_API_KEY=aicu_hack_...
URL は 1 つ
API は OpenAI 互換です。ベース URL と鍵を替えれば、OpenAI の SDK やツールがそのまま動きます。
| 項目 | 値 |
|---|---|
| ベース URL | https://api.aicu.ai/v1 |
| 認証ヘッダ | Authorization: Bearer $AICU_API_KEY |
| モデル一覧（正本） | GET https://api.aicu.ai/v1/models — 鍵は不要 |
curl https://api.aicu.ai/v1/chat/completions \
-H "Authorization: Bearer $AICU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5-mini", "messages": [{"role": "user", "content": "観光客に自転車を貸すスタートアップの名前を 3 つ"}]}'
from openai import OpenAI
client = OpenAI(base_url="https://api.aicu.ai/v1", api_key="aicu_hack_...")
r = client.chat.completions.create(model="gpt-5-mini", messages=[{"role": "user", "content": "一文のピッチを書いて"}])
print(r.choices[0].message.content)
作れるもの
| したいこと | まず使うモデル | ガイド |
|---|---|---|
| コピー・ビジネスモデル・ピッチを書く | gpt-5-mini、gpt-5、deepseek-v3 | Chat (LLM) |
| エージェントでコードを書く | OpenCode・Cline・Continue から kimi-k2.7-code | OpenCode |
| ロゴやサイトの画像を作る | gpt-image-2、nano-banana、sd3.5-large（Stability AI）、qwen-image-3.0 | 画像 |
| 短いティザー動画を作る | wan3.0-video、gemini-omni-1.1-flash | 動画 |
| ナレーションを付ける | eleven_v4_turbo、eleven_v4 | 音声 |
価格は変わるので、ここには書き写しません。 各モデルの価格は GET /v1/models と料金ページにあり、応答ごとの額は X-AICU-AP-Cost ヘッダに出ます（1 USD = 10,000 AP）。
文章・音声合成・文字起こしはほとんど気にならない額です。チームの予算を使い切るのは画像と動画で、長い高解像度の動画 1 本が、その日のほかの全部より高くつくことがあります。まず短く低解像度で試してください。
使えないもの
- Anthropic（Claude）のモデルはありません。
/v1/messagesが無いので、Claude Code をこの API に向けることはできません。コーディングには OpenCode とkimi-k2.7-codeを使ってください。 - Google のモデルは使えますが、ここでは Google 本体より高くなります。 Gemini が中心なら、個人の Google AI Studio や Google Cloud のアカウント（無料枠や試用クレジット）のほうが長く使えます。それ以外にこの鍵を使ってください。
ハッカソンの鍵の上限
上限は鍵の発行時に決まります。個人の鍵（A）なら、ダッシュボードに AICU ID でログインするとハッカソンの欄で見られます。チームの鍵（B）は主催者に聞いてください。
| 上限 | 起きること | すること |
|---|---|---|
| 1 日の上限（必ず設定） | 日本時間の 0 時（冬時間の CET 16 時・UTC 15 時）に戻るまで、有料の呼び出しが断られる | 戻るのを待つか、主催者に相談 |
| 1 回の上限（多くの場合設定） | 403 request_too_expensive — 1 回の額が上限を超える | 解像度・長さ・n を下げる |
| 使えるモデル（設定されることがある） | 403 model_not_allowed | 許可されたモデルを選ぶか、主催者に相談 |
| 期限（必ず設定・最長 14 日） | 401 key_expired | ハッカソンは終わりです。ご利用ありがとうございました |
文字起こし（
/v1/audio/transcriptions）は、1 回の上限がある鍵では使えません。音声を処理するまで額が決まらないためです。必要なら、主催者に別の鍵を頼んでください。
最後まで持たずに予算が尽きたら、主催者に相談してください。同じ鍵にクレジットを足せます。
ルール
- ハッカソンの中だけで使ってください。商用利用、鍵の転売・貸し借りは不可です。
- 利用規約（NSFW や違法なものを作らない、を含む）に従ってください。
- 共有するデモも含め、鍵をどこにも公開しないでください。
うまくいかないとき
- エラーコードを見てください。多くの失敗は、何を直せばよいかを返します。
- 主催者に聞いてください。
- ダッシュボード右側のサポート欄（AICU ID でログイン）か、api@aicu.ai に送ってください。リクエスト（エンドポイント・モデル・送った内容）、時刻（タイムゾーン付き）、戻り値（ステータスと本文）を添えてください。フランス語・英語での質問やバグ報告も歓迎します。バグと認められた呼び出しは返金します。
イベントのあと、主催者にチーム別・種類別（文章・画像・音声・動画）の利用レポートをお渡しします。チームが実際に何を使ったかを見られます。