5分で最初のリクエスト
Kimi API キーを OpenAI 互換のクライアントに貼り付けて、無検閲テキストの生成を開始します。このガイドでは、SDK の構成方法と実際のトークン価格を詳しく説明します。
OpenAI Python/Node SDK のインストール
標準の OpenAI クライアントライブラリからインストールを開始します。これは、当 API が同じ OpenAI 互換インターフェースに従っているためです。専用のベンダー SDK は必要ありません。Python の場合は pip install openai、Node.js の場合は npm install openai を実行するだけです。ライブラリは JSON シリアライゼーションと HTTP リクエストを自動的に処理します。
ベース URL と API キーの設定
クライアントを当社のエンドポイントに接続してください。ベースURLを https://api.kimiapi.top/v1 に設定し、ダッシュボードから取得したAPI キーを入力してください。このキーは前払いクレジットの認証に使用されます。Googleまたはメールでサインアップページから新しいキーを即座に生成できます。開始にクレジットカードは不要です。
curl https://api.kimiapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
最初のチャット完了リクエストの送信
uncensored モデルに簡単なメッセージを送信します。このモデルは、法的な成人向け利用に対して拒否なしで回答するようにチューニングされています。100,000 トークンのコンテキストウィンドウをサポートしますが、最大出力は 32,000 トークンです。応答はテキストとして直接返されます。エラーと拒否はクレジットを消費しません。
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.top/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
SSE によるストリーミングの有効化
リアルタイム応答のためにストリーミングを有効にします。SDK は Server-Sent Events (SSE) 経由でトークンをストリーミングします。最後のチャンクには、請求用の合計トークン使用量が含まれます。このアプローチは、長い出力の知覚されるレイテンシを削減します。アプリケーションロジックでトークンが到着するたびに処理できます。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
構造化出力のための JSON モードの使用
response_format を {"type": "json_object"} に設定して、一貫した機械可読な出力を確保します。これにより、モデルが有効な JSON を返すようになります。データ抽出や設定生成に最適です。モデルは構造を崩さないため、コードでの応答解析が容易になります。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.top/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
使用状況とコストの確認
ダッシュボードで利用状況を確認してください。入力コストは100万トークンあたり$0.25、出力は100万トークンあたり$1.00です。401エラーが発生した場合はキーを確認してください。402エラーはUSDTまたはUSDCでチャージが必要であることを示します。429エラーは1分あたり300リクエストのレート制限に到達したことを意味します。クレジットは期限が切れないため、都合のよい時にチャージしてください。
技術仕様
購入前に確認できるよう、API の実際の制限と機能をすべてまとめました。
| 項目 | 内容 |
|---|---|
| 形式 | OpenAI 互換:どの OpenAI SDK でも base URL とキーを変えるだけで動作 |
| Base URL | https://api.kimiapi.top/v1 |
| エンドポイント | POST /v1/chat/completions · GET /v1/models |
| 認証 | Authorization: Bearer YOUR_KEY |
| モデル ID | uncensored |
| コンテキスト長 | 100,000 トークン(入力+出力) |
| JSON モード | response_format: {"type": "json_object"} |
| 最大出力 | 100,000 トークンのウィンドウの残りまで。max_tokens は任意(個別の上限なし) |
| ストリーミング | 対応 — SSE、最後のチャンクにトークン使用量 |
| パラメータ | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 関数呼び出し | 対応 — tools、tool_choice。応答に tool_calls(ストリーミングでも)、結果は role: tool で返送 |
| レート制限 | キーごとに毎分 300 リクエスト |
| 同時実行 | キーごとに同時 8 リクエストまで |
| リクエストサイズ | 最大 8 MB |
| レスポンスヘッダー | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 課金 | 前払いクレジットから実使用量で課金。エラーと拒否は無料 |
| 有効期限 | 購入クレジットは失効なし、サブスクなし |
| 料金 | 入力 100 万トークン $0.25 · 出力 100 万トークン $1.00 |
| チャージ | USDT(TRC20)または USDC(Base)、$10〜$500 の任意の整数額 |
| 無料トライアル | $0.50、7 日間、カード不要 · トライアルキー: 同時2件、毎分60件。初回チャージ後に上限が8件・300件へ拡大 |
| ボーナス | $50 以上で +5%、$100 以上で +10% |
| ログイン | Google またはメール+パスワード |
| キー | アカウントごとに有効なキーは 1 つ。新しいキーで旧キーは無効 |
| コンテンツ | 成人向けコンテンツ可。未成年者を含む性的コンテンツは拒否 |
エラーコード
エラーは固定の type を持つ JSON で返ります。失敗・拒否されたリクエストは課金されません。
| コード | タイプ | 意味 |
|---|---|---|
400 | bad_request | JSON 不正、メッセージ空、パラメータ誤り、またはコンテキスト超過 |
401 | missing_key · invalid_key · key_revoked | キーなし・誤り・新しいキーに置換済み |
402 | no_credit | 残高ゼロ — チャージすれば即再開 |
403 | content_blocked | 未成年者を含む性的コンテンツ — 拒否、課金なし |
404 | not_found | 不明なエンドポイント |
413 | request_too_large | 本文が 8 MB 超 |
429 | rate_limited · concurrency | 毎分 300 回または同時 8 件を超過 — 待って再試行 |
503 | upstream_busy | モデル混雑 — 数秒後に再試行 |
質問と回答
Kimi API の請求はどのように機能しますか?
実際のトークン使用量に対してのみ課金されます。入力トークンは100万トークンあたり$0.25、出力トークンは100万トークンあたり$1.00です。エラーや拒否は無料です。クレジットは前払いで期限が切れません。
どの暗号通貨の支払いを受け入れていますか?
USDT (TRC20) と USDC (Base) を受け入れています。チャージは $10 から $500 の範囲です。カードや PayPal を介さず、直接決済が処理されます。
コンテキストウィンドウの制限は何ですか?
モデルはプロンプトと completion の両方で 100,000 トークンのコンテキストウィンドウをサポートしています。ただし、指定しない限り、リクエストごとの最大出力は 32,000 トークンです。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベース URL を変更します。セットアップはこれだけです。