Macaron V1 Venti は、OpenAI 互換のチャット補完 API を通じて Novita AI で利用できます。コーディング、エージェントループ、GenUI プロンプトに非常に大きなコンテキストウィンドウが必要な場合に使用し、長いワークフローに拡張する前に、まずは小さなテキストのみのリクエストから始めてください。
モデルの概要については、Novita AI 上の Macaron V1 Venti を参照してください。
このクイックスタートを使用するタイミング
このガイドは、短いチャットの応答ではなく、長いコンテキスト、ツールの使用、またはコードネイティブな UI 生成をワークロードが必要とする場合に使用してください。Macaron V1 Venti の Novita モデルページには、サーバーレスアクセス、関数呼び出し、推論、テキスト入力とテキスト出力が記載されています。
ステップ 1: Novita API キーを取得する
Novita API キーを作成し、サーバー側で保管してください。
export NOVITA_API_KEY="your_api_key_here"
ステップ 2: モデル ID とエンドポイントを確認する
| フィールド | 値 |
|---|---|
| モデル ID | mindai/macaron-v1-venti |
| ベース URL | https://api.novita.ai/openai/v1 |
| チャット補完エンドポイント | https://api.novita.ai/openai/v1/chat/completions |
| コンテキストウィンドウ | 1,048,576 トークン |
| 最大出力トークン数 | 131,072 |
| 入力 | テキスト |
| 出力 | テキスト |
| 機能 | サーバーレス API、関数呼び出し、推論 |
| 表示されるレート制限ティア | T1: 30 RPM、50,000,000 TPM |
2026 年 7 月 28 日 ** 時点で、Novita は Macaron V1 Venti を ** 期間限定無料 、$0 入力 、$0 出力 の料金として掲載していました。本番環境での使用を予算化する前に、ライブモデルページを確認してください。
ステップ 3: 最初のリクエストを送信する
短いテキストのみのプロンプトから始めて、認証、ルーティング、および解析を確認します。
リポジトリ全体のリファクタリングにおける主なリスクを 5 つの箇条書きで要約してください。
ステップ 4: レスポンスを読み取る
標準のチャット補完の場合、choices[0].message.content から応答を読み取ります。リクエストメタデータ、トークン使用量、HTTP ステータスをログに記録しておくと、後で遅い呼び出しや高額な呼び出しを追跡できます。
ステップ 5: 料金、制限、および一般的なエラーを確認する
最新の掲載情報は、古いブログ記事よりも重要です。無料料金、特定のレートティア、または 100 万トークンの完全なコンテキストウィンドウに依存する場合は、起動前にモデルページを再確認してください。
一般的なセットアップの間違いは次のとおりです。
- 表示名の代わりに
mindai/macaron-v1-ventiを使用していない。 - SDK が間違ったベース URL を指している。
- 基本的な接続を確認する前に、巨大なプロンプトを送信している。
- すべての長いコンテキストリクエストが最大出力制限を使用すべきだと想定している。
Python の例
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NOVITA_API_KEY"],
base_url="https://api.novita.ai/openai/v1",
)
response = client.chat.completions.create(
model="mindai/macaron-v1-venti",
messages=[
{"role": "system", "content": "あなたは簡潔なコーディングアシスタントです。"},
{"role": "user", "content": "大規模なモノレポをリファクタリングするための最も安全な最初のステップをリストアップしてください。"},
],
temperature=0.2,
max_tokens=400,
)
print(response.choices[0].message.content)
cURL の例
curl "https://api.novita.ai/openai/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${NOVITA_API_KEY}" \
-d '{
"model": "mindai/macaron-v1-venti",
"messages": [
{
"role": "system",
"content": "You are a concise coding assistant."
},
{
"role": "user",
"content": "List the safest first steps for refactoring a large monorepo."
}
],
"temperature": 0.2,
"max_tokens": 400
}'
主要パラメータ
| パラメータ | 初期値 | 重要な理由 |
|---|---|---|
model |
mindai/macaron-v1-venti |
ホストされているモデルを選択します |
messages |
短いシステム + ユーザープロンプト | API パスを迅速に確認します |
temperature |
0.2 |
テスト出力を安定に保ちます |
max_tokens |
400 |
最初の応答が大きくなりすぎるのを防ぎます |
tools |
一度に 1 つの関数 | エージェントやワークフローに役立ちます |
response_format |
パーサーの準備ができている場合のみ | 出荷前に JSON を検証します |
コーディング、エージェント、GenUI のプロンプト
コーディング
周囲のコンテキストが重要な場合に、リポジトリを認識したリファクタリング、移行計画、またはコードレビューの要約に Macaron V1 Venti を使用します。
このモジュールを移行リスクについてレビューし、破壊的な変更を特定し、最も安全な最小のパッチ計画を提案してください。
エージェント
モデルが直接回答する代わりにツールを選択する必要がある場合は、関数呼び出しを使用します。
ユーザーが既存の課題 ID を参照している場合にのみ、チケット検索ツールを呼び出してください。それ以外の場合は、短い計画で回答してください。
GenUI
プロダクトブリーフから構造化された UI のアイデアを生成する場合に使用します。
このプロダクトブリーフを、セクション、アクション、空の状態、検証ルールを備えたクリーンなダッシュボードレイアウトに変換してください。
トラブルシューティング
API が認証エラーを返す
ベアラートークンがリクエストを行う同じシェルまたはランタイムに設定されていることを確認してください。
モデルが見つからない
モデル ID を再確認してください: mindai/macaron-v1-venti。
リクエストが大きすぎる
小さく始めて、徐々にコンテキストを追加してください。100 万トークンのウィンドウは容量であり、すべてを一度に送信するための合図ではありません。
FAQ
Macaron V1 Venti は Novita AI で利用できますか？
はい。ライブモデルページには、サーバーレスモデルとして記載されています。
どのエンドポイントを使用すればよいですか？
https://api.novita.ai/openai/v1/chat/completions を使用してください。
ツールの使用をサポートしていますか？
はい。Novita はモデルの機能として関数呼び出しをリストしています。
現在、モデルは無料ですか？
2026 年 7 月 28 日に確認した掲載情報では、$0 入力および $0 出力の料金で、期間限定無料と表示されていました。
推奨記事
- Novita AI 上の Macaron V1 Venti: コーディング、エージェント、GenUI のための 748B Mixture-of-LoRA フラッグシップモデル
- Novita AI モデルで Codex を使用する方法: 完全セットアップガイド
- DeepSeek V3 の関数呼び出しを使用する方法
2026 年 7 月 28 日に確認した情報源: Macaron V1 Venti モデルページ、Novita チャット補完 API リファレンス
