1. サインインまたはアカウントの作成
novita.ai にサインインします。Google または GitHub の認証を利用できます。あるいは メールアドレスでサインアップする こともできます。2. API キーの作成
Novita AI は Bearer API キーで API リクエストを認証します。キーを作成または管理するには キー管理 を開き、安全な保管方法については API キー に従ってください。 これらの例では、API キーは必ずNOVITA_API_KEY 環境変数を経由して渡してください。実際の API キーをソースコード、ドキュメント、エージェントとのチャット、分析、スクリーンショット、ログに記載しないでください。
3. 利用可能なクレジットの確認
リクエストを送信する前に、請求と支払い で利用可能なクレジットを確認してください。プロダクトのクレジットとモデルへのアクセスは、リクエストが成功するかどうかに影響する場合があります。より長期的な利用については、自動トップアップ を参照してください。4. 最初の LLM リクエストを送信する
この例を実行する前に、上記のアカウント、API キー、クレジットのステップを完了してください。この例では、OpenAI 互換の chat completions エンドポイントとdeepseek/deepseek-v4.1-flash モデルを使用します。
200 と、"Hello!" のような空でない choices[0].message.content の値が返されます。正確な文言はモデルによって異なる場合があります。HTTP ステータスとレスポンスボディの両方を確認するには、cURL コマンドに --include を追加してください。HTTP 200 だけでは、有効なモデル応答を確認できません。
リクエストが失敗した場合は、該当するガイドを参照してください:
401 Unauthorized: キーの形式と API キーの設定 を確認してください。403 Forbidden: キーが存在しないか無効な場合、Novita ゲートウェイはINVALID_API_KEYを返すことがあります。まずキーを確認してください。モデルアクセスのエラーの場合は、モデルへのアクセス と、本人確認が必要かどうかを確認してください。429 Too Many Requests: レート制限 を確認してください。5xx: 一般的なエラーコード と再試行のガイダンスを確認してください。
5. エージェントを利用する
エージェントは、リクエストの作成と Novita AI の統合を支援できます。上記のアカウント、API キー、クレジットのステップを完了し、エージェントがコードを実行する環境でNOVITA_API_KEY を利用できるようにしてください。Novita AI スキルを読むように依頼してください:
choices[0].message.content を伴う HTTP 200 を確認してください。エージェントのパスが機能しない場合は、手動リクエスト に戻ってください。
6. トラブルシューティング
最初のリクエストを完了できない場合は、次の順序で確認してください:- 現在のシェルで
NOVITA_API_KEY環境変数が設定されていること。 - キーが有効で、
deepseek/deepseek-v4.1-flashへのアクセス権があること。 - アカウントに利用可能なクレジットがあり、必要な確認がすべて完了していること。
- エンドポイント、モデル ID、リクエストボディが例と一致していること。
- 返されたステータスコードが 一般的なエラーコード に記載されていること。