APIドキュメント
Kurogane AI API は OpenAI の Chat Completions API と互換です。
1. APIキーを発行する
ダッシュボードで登録し、「APIキーを発行」を押してください。キーは kg_ で始まり、発行時に一度だけ表示されます。
2. エンドポイント
Base URL: https://kuroganetrading.com/v1
POST /v1/chat/completions
GET /v1/models
3. 使い方
curl
curl https://kuroganetrading.com/v1/chat/completions \
-H "Authorization: Bearer kg_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "kurogane/translate-zh-ja",
"messages": [{"role": "user", "content": "我们可以接受FOB上海的报价。"}]
}'
Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(api_key="kg_xxxxxxxx", base_url="https://kuroganetrading.com/v1")
res = client.chat.completions.create(
model="deepseek/chat",
messages=[{"role": "user", "content": "こんにちは"}],
)
print(res.choices[0].message.content)
Node.js(OpenAI SDK)
import OpenAI from "openai";
const client = new OpenAI({ apiKey: "kg_xxxxxxxx", baseURL: "https://kuroganetrading.com/v1" });
const stream = await client.chat.completions.create({
model: "qwen/plus",
messages: [{ role: "user", content: "見積書のテンプレートを作って" }],
stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
4. モデル一覧
最新の一覧と料金は 料金表 または GET /v1/models で確認できます。kurogane/ で始まるモデルは、日中ビジネス向けに調整した独自プリセットです。
5. エラー
| HTTP | code | 意味 |
|---|---|---|
| 401 | invalid_api_key | APIキーが無効、または削除済み |
| 402 | insufficient_quota | 残高不足 |
| 404 | model_not_found | 存在しないモデル名 |
| 429 | rate_limit_exceeded | 混雑中。少し待って再試行 |
| 502 | upstream_error | 上流AIサービスのエラー |