Macaron V1 Tall은 플래그십 모델로 바로 넘어가지 않고 긴 컨텍스트를 원할 때 사용할 수 있는 더 가벼운 Macaron 옵션입니다. 코딩, 에이전트 루프 또는 GenUI 프롬프트에 사용하고, 더 긴 워크플로우로 확장하기 전에 작은 텍스트 전용 요청부터 시작하세요.
모델 개요는 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 및 엔드포인트 확인
| 필드 | 값 |
|---|---|
| Model ID | mindai/macaron-v1-tall |
| Base URL | https://api.novita.ai/openai/v1 |
| Chat completions endpoint | https://api.novita.ai/openai/v1/chat/completions |
| Context window | 262,144 토큰 |
| Max output tokens | 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 |
한 번에 하나의 함수 | 에이전트 및 워크플로우에 유용합니다. |
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 토큰 윈도우는 용량일 뿐, 모든 것을 한 번에 보내라는 신호가 아닙니다.
FAQ
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 채팅 완성 API 참조
