API 문서
MAI Code 2 API 문서
MAI Code 2 API는 OpenAI Chat Completions 형식을 따릅니다. OpenAI 클라이언트를 아래 Base URL로 지정하고, 키를 Bearer 토큰으로 사용한 뒤 mai-code-2 또는 mai-code-2-flash를 선택하세요.
빠른 시작
- 홈페이지에서 키를 만들고 복사하세요. 키는 sk_maicode2_로 시작합니다.
- $5부터 일회성 결제로 잔액을 충전하세요.
- Base URL과 키로 요청을 보내세요.
https://maicode2.com/v1curl https://maicode2.com/v1/chat/completions \
-H "Authorization: Bearer $MAICODE2_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mai-code-2",
"messages": [{"role": "user", "content": "Write a Python function that checks if a string is a palindrome."}]
}'에디터와 에이전트에서 MAI Code 2 사용하기
OpenAI 호환 제공자를 추가할 수 있는 도구라면 모두 사용할 수 있습니다. Base URL을 설정하고 키를 붙여 넣은 뒤 모델 ID를 입력하세요. 흔한 구성은 채팅과 에이전트에는 MAI Code 2, 자동 완성이나 보조 모델에는 MAI Code 2 Flash를 쓰는 것입니다.
API Provider: OpenAI Compatible
Base URL: https://maicode2.com/v1
API Key: sk_maicode2_your_key
Model ID: mai-code-2VS Code에서 확장 프로그램 설정을 열고 OpenAI Compatible 제공자를 선택하세요.
레퍼런스
POST /v1/chat/completions
응답을 생성합니다. 지원 필드: model, messages, max_tokens 또는 max_completion_tokens, temperature, top_p, stop, stream, stream_options, tools, tool_choice, parallel_tool_calls, response_format, seed, presence_penalty, frequency_penalty, reasoning_effort. 그 밖의 필드는 무시되며 n은 1이어야 합니다.
stream: true로 설정하면 응답이 서버 전송 이벤트로 전달되고 data: [DONE]으로 끝납니다. stream_options.include_usage를 설정하면 마지막에 토큰 수가 담긴 청크를 받습니다.
{
"model": "mai-code-2",
"messages": [{"role": "user", "content": "What is in src/app.ts?"}],
"tools": [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a file from the repository",
"parameters": {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}
}
}]
}GET /v1/models
지금 사용할 수 있는 모델을 나열합니다.
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"GET /v1/balance
키를 소유한 계정의 남은 USD 잔액을 반환합니다.
curl https://maicode2.com/v1/balance -H "Authorization: Bearer $MAICODE2_API_KEY"요금
모든 요청은 사용한 토큰만큼 USD 잔액에서 차감되며 최소 $0.001입니다. 요청 시작 전 예상 입력과 max_tokens 비용이 홀드되고, 끝나면 실제 사용량만 결제되며 나머지는 즉시 돌아옵니다. 잔액이 max_tokens를 감당하지 못하면 더 작은 max_tokens로 실행되며, 256토큰 미만이면 402로 거절됩니다. 실패한 요청은 과금되지 않습니다.
모든 응답에는 X-Request-Id 헤더가 붙습니다. 스트리밍이 아닌 응답에는 최종 청구액을 담은 X-Balance-Charged-Usd도 붙습니다.
가격과 충전 보기 →오류와 제한
오류는 OpenAI 오류 형식을 따르므로 SDK가 평소와 같은 예외를 발생시킵니다.
{
"error": {
"message": "Insufficient balance: this request needs at least $0.004. Add balance at https://maicode2.com/pricing.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}요청과 응답 내용은 저장하지 않습니다. 모델, 토큰 수, 비용, 상태, 시간 같은 측정 데이터만 보관합니다.