이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 7.24.4 · SDK 2.6.7. 영어 원문

무료 티어 API 빠른 시작

상태: 활성 범위: 현재 상태 최종 검토: 2026-08-28 담당: ax-code 런타임

AX Code는 모델 할당량을 제공하지 않습니다. “무료” 실행은 외부 모델 공급자가 제공하는 할당량이나 크레딧을 씁니다. 가용성, 한도, 데이터 조건, 모델 카탈로그는 AX Code와 상관없이 바뀔 수 있습니다.

가장 짧은 지원 경로: Groq

Groq는 기본 AX Code 공급자이고, 현재 AX Code 모델 카탈로그에는 도구를 쓸 수 있는 모델이 들어 있습니다. Groq는 그 모델 ID에 대한 무료 플랜 한도를 공개합니다.

Groq Console에서 Groq 계정과 API 키를 만듭니다.
AX Code에 키를 저장합니다.

ax-code providers login groq

설치한 AX Code 릴리스에서 쓸 수 있는 모델을 확인합니다.

ax-code models groq

ax-code를 열고 /connect를 실행한 뒤, Groq와 나열된 모델 중 하나를 고릅니다. 헤드리스 동작 확인에서 현재 함께 제공되는 카탈로그가 지원하는 것은 다음과 같습니다.

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

ax-code models groq가 그 정확한 모델을 출력하지 않으면, 출력에 있는 모델 ID를 사용합니다. 설치한 릴리스에서는 설치된 카탈로그가 기준입니다.

내장된 무료 티어와 무료 크레딧

이 공급자들은 AX Code의 기본 설정 선택기에 있습니다. “내장”은 AX Code가 프로토콜 어댑터, 모델 메타데이터, 자격 증명 흐름, 공급자 엔드포인트를 제공한다는 뜻입니다. 모든 모델이나 요청이 무료라는 뜻은 아닙니다.

AX Code 공급자	비용이 없는 경로	중요한 제약
`groq`	Groq 무료 플랜	속도 제한은 모델과 계정마다 다릅니다. Groq의 실시간 한도를 확인합니다.
`google`	무료 티어 Gemini API 모델	Gemini API 가격에서 무료로 표시된 모델만 해당합니다. Google은 무료 티어 내용이 제품 개선에 쓰일 수 있다고 말합니다.
`unorouter`	`:free`로 끝나는 모델 ID	UnoRouter는 서드파티 게이트웨이입니다. 무료 모델 한도는 의도적으로 낮고, 가용성은 흔들릴 수 있습니다.
`huggingface`	반복되는 Inference Providers 크레딧	무료 계정은 현재 매달 작은 크레딧을 받으며, 바뀔 수 있습니다. Hugging Face 가격을 보십시오. 에이전트 작업 하나가 그것을 다 쓸 수 있습니다.
`zai`	PAYG API의 현재 GLM-5.3 SKU	AX Code 선택기는 GLM-5.3에서 시작합니다. `zai` 공급자를 연결하고 `zai-coding-plan`는 연결하지 마십시오. 현재 비용이 없는 SKU는 Z.AI 가격에서 확인합니다.
`openrouter`	`openrouter/free` 또는 모델별 `:free` 변형	공급자 프리셋은 내장되어 있지만, AX Code가 선별한 현재 스냅샷에는 무료 라우터가 없습니다. 아래에 보이는 대로 명시적으로 추가합니다.

UnoRouter는 ax-code providers login unorouter로 연결하고 ax-code models unorouter를 실행한 뒤, ID가 :free로 끝나는 모델을 고릅니다. 그 접미사가 없는 유료 쌍을 무료라고 가정하지 마십시오. UnoRouter 자신의 카탈로그는 모든 무료 모델이 도구 호출을 지원하지는 않는다고 적습니다. AX Code는 함께 제공되는 카탈로그에서 도구를 쓸 수 있는 항목만 보여 줍니다.

Google이나 Hugging Face는 맞는 공급자 ID로 연결한 뒤 ax-code models google 또는 ax-code models huggingface를 사용합니다. 모델을 고르기 전에 공급자의 실시간 가격 페이지를 확인합니다.

OpenRouter의 무료 모델 라우터 추가

OpenRouter는 openrouter/free를, 요청과 호환되는 사용 가능한 무료 모델을 고르는 비용 없는 라우터로 문서화합니다. 그 라우터는 AX Code의 현재 선별 스냅샷에 없으므로, 프로젝트 루트의 ax-code.json에 보수적인 로컬 모델 항목을 추가합니다. 전역 AX Code 구성에 병합해도 됩니다.

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

위의 한도는 OpenRouter가 부여한 권리가 아니라, AX Code의 보수적인 예산 값입니다. 그다음 병합된 모델 카탈로그를 연결하고 확인합니다.

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

openrouter가 반복되는 것은 의도적입니다. 첫 구간은 AX Code 공급자 ID이고, openrouter/free는 OpenRouter가 기대하는 모델 ID입니다. 무료 라우터의 가용성과 선택은 요청마다 다릅니다. OpenRouter의 무료 라우터 문서를 보십시오.

외부 무료 API 카탈로그를 쓰는 방법

awesome-free-llm-apis는 현재의 제공을 찾는 데 유용하지만, AX Code의 호환 목록이나 추천 목록은 아닙니다.

지원 공급자와 모델에 있는 공급자에는 기본 AX Code 설정 프리셋이 있습니다.
models-snapshot.json에 있기만 한 공급자는 레지스트리가 뒷받침할 뿐, 기본 설정 흐름을 위해 선별되었다는 뜻은 아닙니다.
다른 서비스는 호환되는 OpenAI 또는 Anthropic 엔드포인트를 노출하면 사용자 지정 공급자와 게이트웨이 공급자를 통해 동작할 수 있습니다.
“OpenAI 호환”은 코딩 에이전트에 필요하지만, 그것으로 충분하지는 않습니다. 고른 모델에는 스트리밍되는 텍스트 응답과, 믿을 수 있는 도구 및 함수 호출도 필요합니다.
서드파티 목록의 공급자 이름, 모델 ID, 무료 할당량, 리전, 계정 요구는 낡을 수 있습니다. 의존하기 전에 공급자 공식의 가격, 모델, 속도 제한 페이지와 대조하여 확인합니다.

이 페이지를 검토한 날짜를 기준으로, 그 카탈로그가 지목한 서비스는 AX Code에 다음과 같이 대응합니다.

AX Code와의 관계	카탈로그 서비스	의미
기본 설정 프리셋	Google Gemini(`google`), Groq(`groq`), OpenRouter(`openrouter`), Hugging Face(`huggingface`), UnoRouter(`unorouter`)	일반적인 공급자 설정 흐름에 보이며, 위에서 다뤘습니다.
레지스트리가 뒷받침하지만 기본 프리셋은 아님	Mistral(`mistral`), Cohere(`cohere`), Zhipu AI(`zhipuai`), AnyAPI(`anyapi`), Cerebras(`cerebras`), NVIDIA NIM(`nvidia`), Cloudflare Workers AI(`cloudflare-workers-ai`)	함께 제공되는 레지스트리에 메타데이터와 어댑터가 있지만, 선별된 기본 설정 흐름의 일부는 아닙니다. 명시적 구성이 무료 모델의 에이전트 도구 지원을 보장하지는 않습니다.
사용자 지정 프로토콜만	Api.Airforce, Kluster AI, LLM7.io, Pollinations AI	AX Code 프리셋이 없습니다. 현재 API가 사용자 지정 공급자 계약과 호환될 때만 정확한 엔드포인트와 모델을 구성합니다.

특히 github-copilot 프리셋은 일부 카탈로그가 나열하는 github-models API가 아닙니다. 한쪽의 공급자 ID나 자격 증명 흐름을 다른 쪽으로 바꾸지 마십시오. zai와 zhipuai 일반 API는 GLM-5.3에서 시작합니다. 더 오래된 GLM 3, GLM 4, GLM-5, GLM-5.2 SKU는 걸러진 채로 남습니다.

안전한 평가 관행

먼저 공개되었거나 버려도 되는 저장소로 시험합니다. 호스트된 공급자나 게이트웨이는 자신의 API로 보낸 프롬프트와 코드 맥락을 받습니다.
workspace-write 격리를 켜거나, 검토만 하는 동작 확인에는 read-only를 사용합니다.
짧은 작업 하나와 에이전트 하나로 시작합니다. Council, arena, 긴 세션, 큰 저장소는 요청을 많이 쓰고 무료 티어 한도에 빨리 닿을 수 있습니다.
자격 증명은 ax-code providers login나 환경 변수에 저장합니다. API 키를 ax-code.json에 커밋하지 마십시오.
429와 일시적인 사용 불가는 무료 티어에서 정상적인 제약으로 취급합니다. 공급자의 재시도 창을 기다리거나, 현재 나열된 다른 무료 모델을 고릅니다.