Documentation
Interactive API Reference
OpenAPI 3.1 仕様 + Scalar UI で全エンドポイントを試せます
OpenAI互換 チャット補完API
各コードブロックの Copy で AI エージェント(Claude Code / Copilot 等)に貼り付け
AICU LLM API Documentation
OpenAI互換のチャット補完API。API キー(Bearer 認証)が必須です。ダッシュボードで
aicu_live_キーを発行してください。
Base URL
https://api.aicu.ai/v1Quick Start
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": "Hello!"}],
"max_tokens": 100
}'🖼️ 画像入力(Vision)にも対応しています。
contentを配列にしてimage_urlを渡すだけ → Vision ガイド
POST /v1/chat/completions
OpenAI互換のチャット補完エンドポイント。
Request:
{
"model": "deepseek-v3",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
],
"max_tokens": 1000,
"temperature": 0.7,
"stream": false
}Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | モデルID |
| messages | array | Yes | メッセージ配列 |
| max_tokens | number | No | 最大トークン数 (default: 4096) |
| temperature | number | No | サンプリング温度 0-2 (default: 1) |
| stream | boolean | No | ストリーミング (default: false) |
Response:
{
"id": "gen-xxx",
"object": "chat.completion",
"created": 1234567890,
"model": "deepseek-v3",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! How can I help you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 15,
"total_tokens": 25
}
}Response Headers:
X-AICU-Model: 使用モデルX-AICU-Provider: プロバイダ (openrouter/groq/aicu)X-AICU-Tokens: 消費トークン数X-AICU-AP-Cost: AP消費X-AICU-Latency-Ms: レイテンシ
GET /v1/chat/models
利用可能なモデル一覧を取得。
curl https://api.aicu.ai/v1/chat/modelsResponse:
{
"object": "list",
"data": [
{
"id": "deepseek-v3",
"owned_by": "openrouter",
"pricing": {"ap_per_1k_tokens": 14, "ap_in_per_1k": 9, "ap_out_per_1k": 27},
"stage": "beta",
"description": "汎用、コスパ良好"
}
]
}Available Models(提供モデル)
料金区分:
- 🟢 無料 … 恒常的に無料(レート制限あり)
- 🟡 期間限定無料 … α / preview 段階。2026-10-31 まで実課金なし(令和8年熊本地震 支援プログラム)。表の AP はGA後の予定単価
- 💠 有料(予定単価) … 表の AP はGA以降に適用される参考単価
現在プラットフォーム全体が α版です。上記いずれも現時点では end-user への実課金を行っていません(利用ログは記録します)。単価は「入力 / 出力 AP per 1K tokens」。1 USD = 10,000 AP(1 AP = $0.0001)。
🟢 無料(Groq・GA後も無料)
| Model | Provider | 単価 | 用途 |
|---|---|---|---|
groq-llama-3.3-70b | Groq | 無料 | 高品質、レート制限あり |
groq-llama-3.1-8b | Groq | 無料 | 高速、レート制限あり |
🟡 期間限定無料(α / preview・2026-10-31 まで)
| Model | Provider | in / out (AP/1K) | 用途 |
|---|---|---|---|
gpt-4o | OpenAI | 76 / 300 | 高品質マルチモーダル |
gpt-4o-mini | OpenAI | 5 / 18 | 軽量・高速 |
gpt-5.6-sol | OpenAI | 150 / 900 | 最上位。難しい推論・長い文脈 |
gpt-5.6-terra | OpenAI | 80 / 450 | sol の半額。日常的な作業の主力 |
gpt-5.6-luna | OpenAI | 30 / 180 | 軽量で速い。対話・要約 |
gpt-5.4-mini | OpenAI | 30 / 140 | 安価。定型の生成・抽出 |
gpt-5.4-nano | OpenAI | 6 / 40 | 最安。分類・判定など短い作業 |
sakura-kimi | さくらのAI Engine | 12 / 60 | 国産推論 Kimi-K2.6。国内推論・学習不使用 |
kimi-k2.7-code | さくらのAI Engine | 11 / 101 | コーディング特化。OpenCode / Cline 互換 |
💠 有料(beta・予定単価)
Gemini 系は 2026-08-01〜 下記の新単価(デフォルト
gemini-flashを軽量な 2.5 Flash-Lite に、最新gemini-3.6-flashを新設)。
| Model | Provider | in / out (AP/1K) | 用途 |
|---|---|---|---|
deepseek-v3 | OpenRouter | 9 / 27 | 汎用、コスパ良好 |
gemini-flash | OpenRouter | 3 / 12 | 軽量・低コスト(Gemini 2.5 Flash-Lite)。2026-08-01〜 |
gemini-3.6-flash | OpenRouter | 45 / 225 | 最新・高品質(Gemini 3.6 Flash)。2026-08-01〜 新設 |
llama-3.1-8b | OpenRouter | 1 / 2 | 軽量 |
llama-3.1-70b | OpenRouter | 4 / 10 | 高品質 |
qwen3-32b | OpenRouter | 4 / 10 | 大規模コンテキスト |
旧世代
gpt-5/gpt-5-mini/gpt-5-nanoも当面は利用可能ですが、新規はgpt-5.6/gpt-5.4系を推奨します。常に最新の一覧はGET /v1/chat/modelsで取得できます(この表は手動更新のため差異がある場合があります)。
推論モデル(reasoning)の注意
GET /v1/chat/models で reasoning: true のモデル(gpt-5 系など)は、思考(reasoning)トークンも課金対象で、max_tokens を小さくすると reasoning が使い切って本文が空(content: "")で返ることがあります。
reasoning_effort(minimal/low/medium/high)を指定して思考量を制御できます(OpenAI 互換で素通し)。- 未指定の
gpt-5系は、api.aicu.ai 側で既定minimalを適用し、短文でも本文が返るようにしています(明示すればそちらを優先)。 - 短文生成でコストと安定性を優先するなら、非推論の
gpt-4o-miniなどが確実です。
curl -X POST 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":"140字で告知文を書いて"}],"max_tokens":600,"reasoning_effort":"minimal"}'OpenAI SDK Compatibility
from openai import OpenAI
client = OpenAI(
base_url="https://api.aicu.ai/v1",
api_key="aicu_live_xxx" # 要 API キー(ダッシュボードで発行)
)
response = client.chat.completions.create(
model="deepseek-v3",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.aicu.ai/v1',
apiKey: 'aicu_live_xxx', // 要 API キー(ダッシュボードで発行)
});
const response = await client.chat.completions.create({
model: 'deepseek-v3',
messages: [{ role: 'user', content: 'Hello!' }],
});Credits (課金)
- 10,000 AP = $1(USD 建て。1 AP = $0.0001。原価がドル建てのため単位もドルに揃えている)
- Groqモデル: 無料(レート制限あり)
- 全エンドポイントで API キー(Bearer 認証)が必須
Rate Limits
| Provider | Limit |
|---|---|
| Groq | 30 RPM |
| OpenRouter | プランに依存 |
Support
- Skill: https://api.aicu.ai/skills/llm
- Dashboard: https://api.aicu.ai/dashboard
- Contact: https://aicu.ai/contact
© 2026 AICU Japan K.K.