Macaron V1 Tall は、フラッグシップに飛びつかずに長いコンテキストを扱いたいときに適した、より軽量な Macaron オプションです。コーディング、エージェントループ、GenUI プロンプトに使用し、長いワークフローに拡張する前に、まずは小さなテキストのみのリクエストから始めてください。
Python コーディングスタックを選ぶ場合は、2026年 Python コーディングに最適な AI を比較してください。
モデル概要については、Novita AI の Macaron V1 Tall を参照してください。
フラッグシップとの比較については、Novita AI の Macaron V1 Venti を参照してください。
このクイックスタートを利用する場面
このガイドは、リポジトリの状態、ツールのトレース、UI 仕様を保持するのに十分なコンテキストが必要だが、カタログ内で最大のコンテキストウィンドウまでは必要ないワークロードに適しています。
ステップ 1: Novita API キーを取得する
Novita API キーを作成し、サーバーサイドで保管してください。
export NOVITA_API_KEY="your_api_key_here"
ステップ 2: モデル ID とエンドポイントを確認する
| フィールド | 値 |
|---|---|
| モデル ID | mindai/macaron-v1-tall |
| ベース URL | https://api.novita.ai/openai/v1 |
| チャット補完エンドポイント | https://api.novita.ai/openai/v1/chat/completions |
| コンテキストウィンドウ | 262,144 トークン |
| 最大出力トークン数 | 32,768 |
| 入力 | テキスト |
| 出力 | テキスト |
| ホスティング | Novita AI サーバーレス API |
2026年7月29日 ** に確認した時点で、Novita は Macaron V1 Tall を期間限定無料 ** として掲載し、入力 $0・** 出力 $0** の価格でした。本番利用の予算を立てる前に、ライブのモデルページを確認してください。
ステップ 3: 最初のリクエストを送信する
認証、ルーティング、解析を確認するために、短いテキストのみのプロンプトから始めてください。
Summarize the main risks in a repository-wide refactor in 5 bullet points.
ステップ 4: レスポンスを読む
標準のチャット補完では、choices[0].message.content から回答を取得します。後で遅い呼び出しや高コストな呼び出しを追跡できるように、リクエストメタデータ、トークン使用量、HTTP ステータスをログに記録してください。
ステップ 5: 価格、制限、よくあるエラーを確認する
最新の掲載情報は、古いブログ記事よりも重要です。無料価格や完全な 262K コンテキストウィンドウに依存する場合は、ローンチ前にモデルページを再確認してください。
よくある設定ミスは次のとおりです。
- 表示名ではなく
mindai/macaron-v1-tallを使う。 - 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-tall",
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,
)
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-tall",
"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-tall |
ホストモデルを選択します |
messages |
短い system + user プロンプト | API パスをすばやく検証します |
temperature |
0.2 |
テスト出力を安定させます |
max_tokens |
400 |
最初のレスポンスが大きくなりすぎるのを防ぎます |
tools |
一度に 1 つの関数 | エージェントやワークフローに役立ちます |
response_format |
パーサーの準備ができている場合のみ | 出荷前に JSON を検証します |
コーディング、エージェント、GenUI プロンプト
コーディング
周囲のコンテキストが重要となる、リポジトリ全体を考慮したリファクタリング、移行計画、コードレビューの要約に Macaron V1 Tall を使用します。
Review this module for migration risks, identify breaking changes, and suggest the smallest safe patch plan.
エージェント
モデルが直接回答するのではなくツールを選択すべき場合は、関数呼び出しを使用します。
Call the ticket lookup tool only if the user references an existing issue ID. Otherwise answer with a short plan.
GenUI
プロダクトブリーフから構造化された UI アイデアを得たいとき、インターフェース生成に使用します。
Turn this product brief into a clean dashboard layout with sections, actions, empty states, and validation rules.
トラブルシューティング
API が認証エラーを返す
リクエストを実行する同じシェルまたはランタイムでベアラートークンが設定されていることを確認してください。
モデルが見つからない
モデル ID を再確認してください: mindai/macaron-v1-tall
リクエストが大きすぎる
小さく始めて、コンテキストを徐々に追加してください。262K トークンウィンドウは容量であり、すべてを一度に送信すべきという意味ではありません。
よくある質問
Macaron V1 Tall は Novita AI で利用できますか？
はい。ライブの掲載情報ではサーバーレスモデルとして表示されています。
どのエンドポイントを使えばよいですか？
https://api.novita.ai/openai/v1/chat/completions を使用してください。
ツール使用をサポートしていますか？
本番でツール呼び出しに依存する前に、最新の機能ラベルをライブのモデルページで確認してください。
現在モデルは無料ですか？
2026年7月29日に確認した掲載情報では、入力 $0・出力 $0 の価格で、期間限定無料と表示されていました。
おすすめ記事
- Novita AI の Macaron V1 Tall: チャット、エージェント、コーディング向け無料 262K コンテキスト MoL モデル
- Novita AI の Macaron V1 Venti クイックスタート: 1M コンテキスト、エンドポイント、例
- Novita AI の Macaron V1 Venti: コーディング、エージェント、GenUI 向け 748B Mixture-of-LoRA フラッグシップ
2026年7月29日確認の情報源: Novita AI モデルライブラリ、Novita chat completions API リファレンス
