mcpField
N
novita-ai

novita-ai

github.com/novitalabsクラウド・DevOps678 回インストール5 週間前に更新
リポジトリ

novita-ai について

novita-aiは、Novita AIプラットフォームの利用を案内するスキルです。モデルAPI、GPU、Agent Sandboxに加え、関連フレームワークやクライアントの手順を扱います。タスクに応じて参照資料へ案内し、変動する情報はライブデータで確認するよう求めます。

主な機能

  1. 01LLM・画像・動画・音声APIの利用
  2. 02GPUインスタンスとサーバーレスGPUの利用
  3. 03SDKまたはCLIによるAgent Sandbox管理
  4. 04フレームワーク・クライアント・監視のガイド参照
  5. 05タスクに応じた参照資料への案内

活用シーン

  1. 01Novita AIモデルAPIを使うアプリの構築
  2. 02画像・動画・音声タスクの生成や処理
  3. 03エージェント向けの隔離コード実行環境の設定
  4. 04GPU・Sandbox・APIの利用方法の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/novitalabs/novita-skills --skill novita-ai

インストール後、Claude Code で/novita-aiを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
audio-api.md
common-issues.md
gpu-api.md
gpu-guide.md
image-api.md
integrations-clients.md
integrations-frameworks.md
integrations-observability-agents.md
integrations.md
llm-api.md
llm-guide.md
quick-start.md
video-api.md

詳細

Novita AI

ビルダーやエージェント向けのAIネイティブクラウドです。1つのプラットフォームでモデルを実行し、GPUをスケールし、AI エージェントを構築できます。

このファイルはエージェント向けのルートです。スキルとしてインストールした場合と、次の場所から直接読み込んだ場合のどちらでも機能する必要があります。 https://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/SKILL.md

ルール

  • NOVITA_API_KEY を使用し、ソースや回答にシークレットを貼り付けないでください。
  • NOVITA_MODEL またはユーザー／アプリケーションがすでに選択しているモデルを使用してください。
  • デフォルトモデルを推奨したり、勝手に設定したりしないでください。モデルが選択されていない場合は、モデルの一覧を表示するか、ユーザーに選択を依頼してください。
  • モデル、料金、レート制限、クォータ、レイテンシ、GPUの在庫、サンドボックスの制限など、変動するデータについて確定値を伝える前に、最新情報を確認してください。
  • 最初にルートを1つ選んでください。タスクが複数の製品にまたがる場合に限り、複数のリファレンスを読んでください。
  • raw読み込みモードでは、ルートテーブルにある該当するrawリファレンスURLを取得してください。
  • <MODEL_NAME>、<TASK_ID>、<INPUT_FILE> などの明示的なプレースホルダーを含む、実行可能なコードまたはコマンドを返してください。
  • ユーザーが安全なURLを明示的に提供している場合を除き、画像、動画、音声の入力には、信頼できるローカルメディアファイルを使用してください。

定数

項目値
APIベースhttps://api.novita.ai
OpenAI互換ベースhttps://api.novita.ai/openai
OpenAI互換v1ベースhttps://api.novita.ai/openai/v1
APIキーNOVITA_API_KEY
モデルNOVITA_MODEL
モデルカタログhttps://novita.ai/models
料金https://novita.ai/pricing
コンソールhttps://novita.ai/console
APIキーhttps://novita.ai/settings/key-management

ルートテーブル

ユーザーの目的インストール済みのリファレンスRaw 読み込み URLライブソース
最初の API 呼び出し、API キー、ベース URLreferences/quick-start.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/quick-start.mdhttps://novita.ai/settings/key-management
チャット、OpenAI SDK、ストリーミング、ツール、JSON、ビジョン、バッチreferences/llm-guide.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/llm-guide.mdhttps://novita.ai/docs/api-reference/model-apis-llm-create-chat-completion
LLM パラメーター、埋め込み、リランク、ファイル、バッチエンドポイントreferences/llm-api.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/llm-api.mdhttps://novita.ai/docs/api-reference/model-apis-llm-create-chat-completion
画像生成・編集、背景、インペイント、アップスケールreferences/image-api.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/image-api.mdhttps://novita.ai/docs
動画生成・編集、動画タスクのポーリングreferences/video-api.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/video-api.mdhttps://novita.ai/docs
TTS、ASR、音声クローンreferences/audio-api.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/audio-api.mdhttps://novita.ai/docs
GPU インスタンス、サーバーレス GPU、テンプレート、ストレージreferences/gpu-guide.md または references/gpu-api.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/gpu-guide.mdhttps://novita.ai/docs/guides/gpu-instance-overview
エージェント Sandbox SDK、E2B 互換性、料金組み込みの Sandbox セクション。詳細は novita-sandbox リファレンスを参照https://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-sandbox/references/sandbox-guide.mdhttps://novita.ai/docs/guides/sandbox-overview
エージェント Sandbox CLI：作成、一覧表示、接続、終了、ログ、クローン、コミット、テンプレートのビルド、エージェントのデプロイ組み込みの Sandbox セクション。詳細は novita-sandbox スキルを参照https://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-sandbox/SKILL.mdhttps://novita.ai/docs/guides/sandbox-sdk-and-cli
LangChain、LlamaIndex、OpenAI Agents SDKreferences/integrations-frameworks.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/integrations-frameworks.mdhttps://novita.ai/docs/guides/langchain
Cursor、Continue、Claude Code、Dify、LobeChat、ChatBoxreferences/integrations-clients.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/integrations-clients.mdhttps://novita.ai/docs
LiteLLM、Portkey、Langfuse、Browser Use、Skyvern、Axolotlreferences/integrations-observability-agents.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/integrations-observability-agents.mdhttps://novita.ai/docs
認証、請求、クォータ、レート制限、リクエストの失敗references/common-issues.mdhttps://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/references/common-issues.mdhttps://novita.ai/docs/guides/faq

モデルの選択

次の順序で選択します。

  1. ユーザーが指定したモデル。
  2. 既存のプロジェクト設定または NOVITA_MODEL。
  3. ライブカタログを照会し、その後ユーザーに確認するか、ユーザーが選択基準を指定した場合に限り選択します。
curl https://api.novita.ai/openai/v1/models \
  -H "Authorization: Bearer $NOVITA_API_KEY"

最小限の LLM 呼び出し

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ["NOVITA_API_KEY"],
)

response = client.chat.completions.create(
    model=os.environ["NOVITA_MODEL"],
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=512,
)

print(response.choices[0].message.content)

curl https://api.novita.ai/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -d '{
    "model": "'"$NOVITA_MODEL"'",
    "messages": [{"role": "user", "content": "Hello"}],
    "max_tokens": 512
  }'

非同期タスク

画像 API と動画 API は、多くの場合 task_id を返します。結果をポーリングします。

curl "https://api.novita.ai/v3/async/task-result?task_id=<TASK_ID>" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

エージェント Sandbox

分離されたコード実行、ファイル操作、テンプレート、長時間稼働するエージェント環境、E2B 互換ワークフローには Sandbox を使用します。一般的な Sandbox タスクはこちらで扱い、CLI の詳細については novita-sandbox を参照します。

SDK の基本設定
pip install novita-sandbox
export NOVITA_API_KEY=<YOUR_API_KEY>

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create()
execution = sandbox.run_code("print('hello world')")
print(execution.logs)
sandbox.kill()

ユーザーが Node.js を使用している場合は、JavaScript／TypeScript に相当するものを生成します。

CLI の基本設定

Node.js を確認し、CLI をインストールまたは更新します。

if ! command -v node >/dev/null 2>&1; then
  echo "Install Node.js first"
elif ! command -v novita-sandbox-cli >/dev/null 2>&1; then
  npm install -g novita-sandbox-cli@beta
else
  novita-sandbox-cli --version
fi

必要に応じて認証します。

novita-sandbox-cli auth info || novita-sandbox-cli auth login
CLI ワークフロー
# Template
novita-sandbox-cli template init
novita-sandbox-cli template build -n <TEMPLATE_NAME>
novita-sandbox-cli template list

# Sandbox lifecycle. Use --detach inside AI agents; interactive terminals usually fail there.
novita-sandbox-cli sandbox create <TEMPLATE_ID> --detach
novita-sandbox-cli sandbox list
novita-sandbox-cli sandbox logs <SANDBOX_ID> -f
novita-sandbox-cli sandbox metrics <SANDBOX_ID> -f
novita-sandbox-cli sandbox clone <SANDBOX_ID> --count <N>
novita-sandbox-cli sandbox commit <SANDBOX_ID> --alias <ALIAS>
novita-sandbox-cli sandbox kill <SANDBOX_ID>

# Deploy and invoke an agent. Pass env vars explicitly; sandbox processes do not inherit local shell env.
novita-sandbox-cli agent configure -n <AGENT_NAME> -e <ENTRYPOINT>
novita-sandbox-cli agent launch
novita-sandbox-cli agent invoke '{"prompt":"hello"}' --stream --env NOVITA_API_KEY=$NOVITA_API_KEY

正確なフラグ、テンプレートのバージョン管理、E2B との互換性、料金、クォータの動作については、上の表にある Sandbox の項目を参照してください。

エラー時の基本対応

  • 401／403：キー、アカウントのステータス、Authorization: Bearer ... を確認します。
  • 404／モデルが見つからない：最新のカタログで正確なモデル ID を確認します。
  • 429：同時実行数を減らし、バックオフを行い、レート制限とアカウントのティアを確認します。
  • クレジット不足：請求情報と残高を確認します。
  • 時間のかかるメディア処理：非同期ポーリングまたは Webhook を使用します。

コメント

Markdown 対応