APIトラブルシューティング
Kimi APIを利用する開発者向けの、よくある問題と解決策です。
429 rate limitエラーにはどう対処すればよいですか？
429エラーは、リクエスト頻度が現在のアカウントのrate limitを超えたことを示します。解決するには、次をお試しください。
- 指数バックオフによるリトライ戦略を実装します（再試行前に1秒、2秒、4秒…と待機）。
- キューの仕組みを��って同時リクエスト数を制御します。
- 累計チャージ金額を増やし、rate limitのティアを引き上げます。
- より大きなquotaが必要な場合は、営業チームにお問い合わせください。
401認証エラーにはどう対処すればよいですか？
401エラーは、API Key認証に失敗したことを示します。以下を確認してください。
- API Keyが正しくコピーされていることを確認します（先頭や末尾の空白に注意してください）。
- リクエストヘッダーの形式が
Authorization: Bearer <your-api-key>であることを確認します。 - API Keyが削除または無効化されていないことを確認します。コンソールで確認できます。
- 別のプラットフォームのキーを使用していないことを確認します（Kimi API Keysは
sk-で始まります）。
API Key形式: Kimi API Keysは sk- で始まります。正しい形式のキーを使用していることを確認してください。
ファイルのアップロードには料金がかかりますか？
ファイルのアップロード自体は無料です。ただし、アップロードしたファイルを会話内で参照すると、その内容がtokensに解析され、入力tokensとして課金されます。ファイルが大きいほど、生成されるtokensも多くなります。
403残高不足エラーにはどう対処すればよいですか？
403エラーは通常、アカウント残高が不足していることを示します。コンソールでチャージしてください。入金額はすぐに利用できます。残高照会APIを使って現在の残高を確認することもできます。
レスポンスが途中で切れる場合は？
APIレスポンスが不完全、または途中で切れている場合は、以下を確認してください。
max_tokensパラメーターの値が小さすぎないか確認し、必要に応じて増やします。- レスポンス内の
finish_reasonフィールドを確認します。lengthはtoken上限により出力が切り詰められたことを、stopは正常に完了したことを意味します。 - 長文生成では、リクエストを複数のセグメントに分けることを検討してください。
finish_reason を確認: length = 途中で切り詰め、stop = 正常完了。
ファイルAPIで画像をアップロードできますか？
はい。ファイルアップロードAPIは画像ファイルに対応しています。アップロード後、画像を会話内で参照できます。Visionモデルでは、URLまたはBase64エンコードを使って、メッセージ内で画像を直接渡すこともできます。
Web Searchの情報源は？
Kimi APIのWeb Search機能は、インターネット上で公開されている情報をリアルタイムに取得します。結果は、主要な検索エンジンにインデックスされたWebページから取得されます。Web Searchを1回呼び出すごとに、追加で$0.004の料金が発生します。
KimiのメンバーシップとAPI concurrencyに関係はありますか？
Kimiメンバーシッププラン（Allegrettoなど）とAPIは、別々の課金システムです。メンバーシッププランに含まれるエージェントの並列実行数はKimiの一般ユーザー向け製品にのみ適用され、API rate limitとは関係ありません。API concurrency上限は、アカウントの累計チャージ額のティアによって決まります。
APIとKimi Webアプリの違い
| 観点 | Kimi Webアプリ | Kimi API |
|---|---|---|
| 対象 | 一般ユーザー向けの対話型製品 | 開発者向けの連携インターフェース |
| アクセス | ブラウザー経由 | プログラムによるAPI呼び出し |
| 課金 | メンバーシップ／creditシステム | tokensに基づく従量課金 |
| アカウント | 共通ログイン | 共通ログイン |
| Credits | システム間で移行不可 | システム間で移行不可 |
PPT生成とDeep ResearchはAPIで利用できますか？
PPT生成とDeep Researchは、現時点ではAPIで利用できません。これらの機能は現在、Kimiの一般ユーザー向け製品からのみ利用できます。更新情報はプラットフォームのお知らせをご確認ください。
オンプレミス導入に対応していますか？
Kimi APIは現在、クラウドベースのAPIサービスのみを提供しており、オンプレミスのプライベートデプロイには対応していません。プライベートデプロイが必要な場合は、platform.kimi.ai/contact-salesから営業チームにお問い合わせください。
中国国外からKimi APIを呼び出せますか？
Kimi APIは api.moonshot.ai を通じて国際的に利用できます。接続に問題がある場合は、お住まいの地域に最適な解決策について営業チームにご相談ください。