Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Ücretsiz katman API hızlı başlangıç

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-08-28 Sahip: ax-code runtime

AX Code model kotası sağlamaz. «Ücretsiz» bir çalıştırma, dış bir model sağlayıcısının sunduğu kota veya krediyi kullanır; bunların kullanılabilirliği, sınırları, veri koşulları ve model kataloğu AX Code’dan bağımsız değişebilir.

En kısa desteklenen yol: Groq

Groq varsayılan bir AX Code sağlayıcısıdır, güncel AX Code model kataloğu araç kullanabilen modeller içerir ve Groq bu model kimlikleri için ücretsiz plan sınırlarını yayımlar.

Groq konsolunda bir Groq hesabı ve API anahtarı oluşturun.
Anahtarı AX Code içinde saklayın:

ax-code providers login groq

Kurulu AX Code sürümünüzde kullanılabilir modelleri doğrulayın:

ax-code models groq

ax-code açın, /connect çalıştırın ve Groq ile listelenen modellerden birini seçin. Başsız bir duman sınaması için güncel paketli katalog şunu destekler:

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

Bu tam model ax-code models groq tarafından yazdırılmazsa, yazdırılan bir model kimliğini kullanın. Kurulu katalog, kurulu sürüm için yetkilidir.

Yerleşik ücretsiz katman ve ücretsiz kredi seçenekleri

Bu sağlayıcılar AX Code’un varsayılan kurulum seçicisindedir. «Yerleşik» demek, AX Code’un protokol bağdaştırıcısını, model üst verisini, kimlik bilgisi akışını ve sağlayıcı uç noktasını sağladığıdır; her modelin veya isteğin ücretsiz olduğu anlamına gelmez.

AX Code sağlayıcısı	Ücretsiz yol	Önemli kısıt
`groq`	Groq ücretsiz planı	Hız sınırları model ve hesap başınadır; Groq canlı sınırlarını denetleyin.
`google`	Ücretsiz katman Gemini API modelleri	Yalnızca Gemini API fiyatlandırmasında ücretsiz işaretlenen modeller uygundur. Google, ücretsiz katman içeriğinin ürünlerini iyileştirmek için kullanılabileceğini belirtir.
`unorouter`	`:free` ile biten model kimlikleri	UnoRouter üçüncü taraf bir ağ geçididir. Ücretsiz model sınırları bilerek düşüktür ve kullanılabilirlik dalgalanabilir.
`huggingface`	Yinelenen Inference Providers kredisi	Ücretsiz hesaplar şu anda değişebilen küçük bir aylık kredi alır; bkz. Hugging Face fiyatlandırması. Tam bir ajan görevi bunu tüketebilir.
`zai`	PAYG API üzerindeki güncel GLM-5.3 SKU değerleri	AX Code seçicisi GLM-5.3 ile başlar. `zai` sağlayıcısını bağlayın, `zai-coding-plan` değil, ve güncel ücretsiz SKU için Z.AI fiyatlandırmasını denetleyin.
`openrouter`	`openrouter/free` veya modele özgü bir `:free` çeşidi	Sağlayıcı hazır ayarı yerleşiktir, ancak AX Code küratörlü anlık görüntüsü şu anda ücretsiz yönlendiriciyi listelemez. Aşağıda gösterildiği gibi açıkça ekleyin.

UnoRouter için ax-code providers login unorouter ile bağlanın, ax-code models unorouter çalıştırın ve kimliği :free ile biten bir model seçin. Bu sonek olmadan ücretli ikizin ücretsiz olduğunu varsaymayın. UnoRouter’ın kendi kataloğu, her ücretsiz modelin araç çağırmayı desteklemediğini belirtir; AX Code paketli kataloğunda yalnızca araç kullanabilen girdileri gösterir.

Google veya Hugging Face için eşleşen sağlayıcı kimliğiyle bağlanın, sonra ax-code models google veya ax-code models huggingface kullanın. Model seçmeden önce sağlayıcının canlı fiyatlandırma sayfasını denetleyin.

OpenRouter ücretsiz model yönlendiricisini ekleme

OpenRouter, istekle uyumlu kullanılabilir bir ücretsiz model seçen sıfır maliyetli bir yönlendirici olarak openrouter/free belgeler. Bu yönlendirici AX Code’un güncel küratörlü anlık görüntüsünde olmadığı için proje kökünüzdeki ax-code.json dosyasına (veya genel AX Code yapılandırmanıza birleştirerek) tutucu bir yerel model girdisi ekleyin:

{
  "$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,
          },
        },
      },
    },
  },
}

Yukarıdaki sınırlar, OpenRouter’dan bir hak değil, tutucu AX Code bütçe değerleridir. Sonra birleştirilmiş model kataloğunu bağlayıp doğrulayın:

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."

Yinelenen openrouter kasıtlıdır: ilk parça AX Code sağlayıcı kimliğidir ve openrouter/free OpenRouter’ın beklediği model kimliğidir. Ücretsiz yönlendirici kullanılabilirliği ve seçimi isteğe göre değişir; bkz. OpenRouter ücretsiz yönlendirici belgeleri.

Dış ücretsiz API kataloğu nasıl kullanılır

awesome-free-llm-apis güncel teklifleri keşfetmek için yararlıdır, ancak bir AX Code uyumluluk veya onay listesi değildir:

Desteklenen sağlayıcılar ve modeller içindeki bir sağlayıcının varsayılan bir AX Code kurulum hazır ayarı vardır.
Yalnızca models-snapshot.json içinde bulunan bir sağlayıcı kayıt desteklidir; varsayılan kurulum akışı için mutlaka küratörlü değildir.
Başka bir hizmet, uyumlu bir OpenAI veya Anthropic uç noktası açtığında Özel ve ağ geçidi sağlayıcıları üzerinden çalışabilir.
«OpenAI uyumlu» bir kodlama ajanı için gerekli ama yeterli değildir. Seçilen modelin ayrıca akan metin yanıtlarına ve güvenilir araç veya işlev çağırmaya ihtiyacı vardır.
Üçüncü taraf listelerdeki sağlayıcı adları, model kimlikleri, ücretsiz kotalar, bölgeler ve hesap gereksinimleri eskiye bilir. Onlara güvenmeden önce sağlayıcının resmi fiyatlandırma, model ve hız sınırı sayfalarına karşı doğrulayın.

Bu sayfanın inceleme tarihinde, o kataloğun adlandırdığı hizmetler AX Code ile şöyle eşleşir:

AX Code ilişkisi	Katalog hizmetleri	Anlam
Varsayılan kurulum hazır ayarı	Google Gemini (`google`), Groq (`groq`), OpenRouter (`openrouter`), Hugging Face (`huggingface`), UnoRouter (`unorouter`)	Normal sağlayıcı kurulum akışında görünür ve yukarıda ele alınır.
Kayıt destekli, varsayılan hazır ayar değil	Mistral (`mistral`), Cohere (`cohere`), Zhipu AI (`zhipuai`), AnyAPI (`anyapi`), Cerebras (`cerebras`), NVIDIA NIM (`nvidia`), Cloudflare Workers AI (`cloudflare-workers-ai`)	Paketli kayıtta üst veri ve bir bağdaştırıcı vardır, ancak sağlayıcı küratörlü varsayılan kurulum akışının parçası değildir. Açık yapılandırma, ücretsiz bir modelin ajan araçlarını desteklediğini garanti etmez.
Yalnızca özel protokol	Api.Airforce, Kluster AI, LLM7.io, Pollinations AI	AX Code hazır ayarı yoktur. Güncel API’si özel sağlayıcı sözleşmesi ile uyumluysa tam uç noktayı ve modeli yapılandırın.

Özellikle github-copilot hazır ayarı, bazı katalogların listelediği github-models API’si değildir. Bir sağlayıcı kimliğini veya kimlik bilgisi akışını diğeriyle değiştirmeyin. zai ve zhipuai genel API’leri GLM-5.3 ile başlar; daha eski GLM 3, GLM 4, GLM-5 ve GLM-5.2 SKU değerleri süzülmüş olarak kalır.

Güvenli değerlendirme uygulamaları

Önce genel veya tek kullanımlık bir depo ile sınayın. Barındırılan bir sağlayıcı veya ağ geçidi, API’sine gönderilen istemleri ve kod bağlamını alır.
workspace-write yalıtımını açın veya yalnızca inceleme amaçlı bir duman sınaması için read-only kullanın.
Kısa bir görev ve tek bir ajanla başlayın. Konsey, arena, uzun oturumlar ve büyük depolar çok sayıda istek tüketebilir ve ücretsiz katman sınırlarına hızla çarpabilir.
Kimlik bilgilerini ax-code providers login veya bir ortam değişkeniyle saklayın; API anahtarlarını asla ax-code.json içine işlemeyin.
429 ve geçici kullanılamazlığı normal ücretsiz katman kısıtları olarak ele alın. Sağlayıcının yeniden deneme penceresini bekleyin veya şu anda listelenen başka bir ücretsiz model seçin.