kimiapikey.comドキュメント
Kimi API:5分以内で最初のリクエスト
標準的なOpenAI互換インターフェースを使用して、5分以内で最初のレスポンスを取得してください。このガイドでは、セットアップ、認証、および無検閲モデルの基本使用方法について説明します。
前提条件
始めるには、kimiapikey.comからのAPIキーが必要です。メールアドレスとパスワードだけでサインアップできます。無料トライアルにはクレジットカードは不要です。また、公式または互換性の高いSDKがインストールされた対応言語環境が必要です。当APIはOpenAIのchat-completions形式に従っているため、GPT-3.5/4用の既存コードは最小限の変更で動作することが多いです。SDKのバージョンがbase_urlパラメータをサポートしているか確認してください。
ベースURLと認証
当APIはhttps://api.kimiapikey.com/v1に配置されています。認証は標準のAuthorizationヘッダーで処理されます。キーをBearerトークンとして渡してください。これはOpenAI互換エンドポイントを受け入れるあらゆるクライアントで動作します。プロキシやカスタムクライアントを使用する場合は、Authorizationヘッダーが正しく転送されることを確認してください。リクエストするモデルIDはuncensoredです。
最初のリクエスト
セットアップを確認するために、シンプルなチャット補完リクエストを送信してください。以下のcurlコマンドを使用し、YOUR_API_KEYを実際のAPIキーに置き換えてください。このリクエストはuncensoredモデルに短いプロンプトを送信します。成功すれば、モデルの応答を含むJSONレスポンスが返されます。生成されたテキストはchoices配列で確認してください。401エラーが発生した場合は、APIキーが無効または期限切れです。
Python SDK
最も簡単な統合には、公式のOpenAI Pythonライブラリを使用してください。base_urlを当社のエンドポイントに設定し、APIキーを入力してください。この例は基本的なテキスト生成リクエストを示しています。必要に応じてmodelパラメータを調整できますが、デフォルトはuncensoredです。この方法により、コードは異なるOpenAI互換サービス間でポータブルになります。
Node SDK
JavaScript/TypeScriptプロジェクトでは、openainpmパッケージを使用してください。クライアントを当ベースURLとAPIキーで構成します。これにより、Node環境から直接リクエストを送信できます。構文はPython SDKと一致するため、言語を切り替えた場合でも一貫性が保たれます。awaitを使用して非同期レスポンスを正しく処理することを忘れないでください。
ストリーミングレスポンス
リアルタイム出力にはSDKでストリーミングを有効にしてください。これにより、テキストが生成されるたびにチャンクが送信され、知覚されるレイテンシが軽減されます。リクエストでstreamフラグを使用してください。SDKは部分的なレスポンスを返すため、UIを段階的に更新できます。これは即時フィードバックが価値のあるチャットインターフェースや長文コンテンツ生成に最適です。
制限とエラー
各キーは1分あたり300リクエストに制限されています。これを超えると、429エラーが発生します。リクエストボディは8 MBを超えてはいけません。100,000トークンのコンテキストウィンドウは、プロンプトと補完の合計に適用されます。一般的なエラーには、401(無効なキー)と402(クレジット不足)があります。APIを引き続き使用するには、ダッシュボードからチャージしてください。クレジットは期限切れにならず、月額料金もありません。
cURL
curl https://api.kimiapikey.com/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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapikey.com/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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.com/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);ストリーミング
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)質問と回答
APIは関数呼び出しに対応していますか?
はい、エンドポイントは標準OpenAI形式で関数呼び出しをサポートしています。リクエストでツールを定義すると、モデルが構造化された引数を返します。
レート制限を超えた場合はどうなりますか?
429 Too Many Requestsエラーが発生します。少し待ってから再試行するか、より高いスループットを維持するために前払いクレジットのティアをアップグレードしてください。
モデルは私のデータで学習していますか?
いいえ。APIに送信されたプロンプトは学習に使用されません。あなたのデータは非公開のまま維持され、ベースモデルの改善には使用されません。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。セットアップはこれだけです。
技術仕様
購入前に確認できるよう、API の実際の制限と機能をすべてまとめました。
| 項目 | 内容 |
|---|---|
| 形式 | OpenAI 互換:どの OpenAI SDK でも base URL とキーを変えるだけで動作 |
| モデル ID | uncensored |
| 認証 | Authorization: Bearer YOUR_KEY |
| エンドポイント | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| 最大出力 | 100,000 トークンのウィンドウの残りまで。max_tokens は任意(個別の上限なし) |
| パラメータ | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 関数呼び出し | 対応 — tools、tool_choice。応答に tool_calls(ストリーミングでも)、結果は role: tool で返送 |
| ストリーミング | 対応 — SSE、最後のチャンクにトークン使用量 |
| コンテキスト長 | 100,000 トークン(入力+出力) |
| JSON モード | response_format: {"type": "json_object"} |
| 同時実行 | キーごとに同時 8 リクエストまで |
| レート制限 | キーごとに毎分 300 リクエスト |
| レスポンスヘッダー | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| リクエストサイズ | 最大 8 MB |
| 料金 | 入力 100 万トークン $0.15 · 出力 100 万トークン $0.50 |
| 課金 | 前払いクレジットから実使用量で課金。エラーと拒否は無料 |
| ボーナス | $50 以上で +5%、$100 以上で +10%、$200 以上で +15% |
| 有効期限 | 購入クレジットは失効なし、サブスクなし |
| チャージ | USDT(TRC20)または USDC(Base)、$20〜$500 の任意の整数額 |
| 無料トライアル | $0.50、7 日間、カード不要 · トライアルキー: 同時2件、毎分60件。初回チャージ後に上限が8件・300件へ拡大 |
| キー | アカウントごとに有効なキーは 1 つ。新しいキーで旧キーは無効 |
| ログイン | Google またはメール+パスワード |
| コンテンツ | 成人向けコンテンツ可。未成年者を含む性的コンテンツは拒否 |
エラーコード
エラーは固定の 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 | モデル混雑 — 数秒後に再試行 |