Macaron V1 Venti は、コード、エージェント、GenUI 向けの 100万トークンコンテキストワークフローが必要な場合に、Novita のフラッグシップ Macaron モデルへの最速のパスです。まずは小さなテキストのみのリクエストから始め、エンドポイントと認証が動作してからスケールアップしてください。
モデルの概要については、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 フラッグシップ
- Macaron V1 Tall クイックスタート：コーディング、エージェント、GenUI 向け
- Novita AI モデルで Codex を使用する方法：完全セットアップガイド
確認日：2026年7月28日。出典：Macaron V1 Venti モデルページ、Novita チャット補完 API リファレンス
