~/tools / Yerel LLM'i kendi sunucunuzda çalıştırın / Ollama API Request Builder
Ollama API Request Builder — Ollama'nın /api/chat uç noktasına curl isteği oluşturun: format, tools, think, options
Ollama'nın /api/chat uç noktasına yönelik bir isteği bir formdan oluşturun: model, bir sistem ve bir kullanıcı mesajı, format ve bir JSON Schema ile yapılandırılmış çıktı, araç tanımları, thinking, akış, temperature ve num_ctx gibi seçenekler, durdurma dizileri ve keep_alive. Çalıştırmaya hazır bir curl komutu ve JSON gövdesi elde edersiniz. Her alan resmî Ollama API başvuru belgesinden gelir. Hiçbir veri tarayıcınızdan çıkmaz.
Seçenekler, durdurma dizileri ve keep_alive
Boş alanlar gönderilmez, böylece modelin ayarları geçerli kalır.
curl komutu
Ollama'ya erişebilen bir makinedeki terminalde çalıştırın.
curl http://localhost:11434/api/chat -d '{
"model": "qwen3:4b",
"messages": [
{
"role": "user",
"content": "Tell me about Canada."
}
],
"format": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"capital": {
"type": "string"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"capital",
"languages"
]
},
"options": {
"temperature": 0
},
"stream": false
}'JSON gövdesi
{
"model": "qwen3:4b",
"messages": [
{
"role": "user",
"content": "Tell me about Canada."
}
],
"format": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"capital": {
"type": "string"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"capital",
"languages"
]
},
"options": {
"temperature": 0
},
"stream": false
}Alanlar, /api/chat için Ollama API başvuru belgesinde verildiği gibidir; 2026-11-03 tarihinde denetlendi. Ollama API: Generate a chat message
Her şey tarayıcınızda yapılır. Araç yalnızca komutu yazar ve hiçbir şey göndermez.
Ollama'nın /api/chat uç noktası, bir model ve bir messages listesi içeren bir JSON gövdesi ile isteğe bağlı şu alanları alır: işlev çağırma için tools, JSON yanıt ya da bir JSON Schema'ya uyan yanıt için format, temperature ve num_ctx gibi ayarlar için options, ayrıca stream, think ve keep_alive. Bu gövdeyi terminalde elle yazmak hataya açıktır: eksik bir virgül onu bozar, bir mesajdaki kesme işareti kabuk tırnağını bitirir ve metin olarak yazılan bir sayı sayı olarak okunmayabilir. Bu araç gövdeyi bir formdan oluşturur ve Ollama belgelerindeki örneklerin biçiminde bir curl komutuna sarar; kesme işaretlerini kabuk için kaçırır. JSON Schema'nın ve araç listesinin geçerli JSON olduğunu, her aracın API başvuru belgesinin istediği type, name ve parameters alanlarına sahip olduğunu ve options değerlerinin doğru türde sayılar olduğunu denetler. Oluşturulan komutları qwen2.5:7b ile Ollama 0.40.11 üzerinde çalıştırdık: bir JSON Schema isteği o biçimde bir yanıt döndürdü, bir araçlı istek bir araç çağrısı döndürdü; akış, json modu, durdurma dizileri ve keep_alive hatasız çalıştı.
Bu aracın temel mantığı MIT lisansıyla açık kaynaktır. github.com/seigo5555/toolkitbox-lib/src/ollama-api-request.ts
Kullanım örnekleri
- Kod yazmadan önce yapılandırılmış çıktıyı kendi sunucunuzda denemek: bir JSON Schema yapıştırın ve modelin ne döndürdüğüne bakın
- Bir modelin, uygulamanızda kullanmayı planladığınız araç tanımıyla işlevinizi çağırıp çağırmadığını denetlemek
- Parolalı bir nginx vekil sunucusunun arkasındaki Ollama'yı doğru URL ve curl -u ile çağırmak
Nasıl kullanılır
- Ollama sunucunuzun adresini (boş bırakırsanız http://localhost:11434) ve model adını girin, ardından kullanıcı mesajını ve isterseniz bir sistem mesajı yazın.
- Bir çıktı biçimi seçin, araç tanımlarını bir JSON dizisi olarak ekleyin, thinking ve akışı ayarlayın. temperature, num_ctx, bir seed, durdurma dizileri veya keep_alive ayarlamak için Seçenekler bölümünü açın. Boş alanlar çıktıya yazılmaz.
- curl komutunu kopyalayın ve Ollama'ya erişebilen bir makinedeki terminalde çalıştırın. Kendi kodunuzdan göndermek isterseniz JSON gövdesi ayrıca gösterilir.
SSS
stream ne yapar?
API başvuru belgesi stream için varsayılan olarak true verir. Akışla gelen yanıt, her seferinde bir parça olacak şekilde satır sonlarıyla ayrılmış JSON olarak ulaşır. stream false olduğunda belgeler yanıtın tek bir JSON nesnesi olarak döndüğünü söyler; akış sayfası bunu işlemesi daha basit olan ve kısa yanıtlar ya da yapılandırılmış çıktılar için daha iyi olan seçenek olarak tanımlar. Araç "stream": false değerini yalnızca akışı kapattığınızda yazar.
think hangi değerleri alabilir?
API başvuru belgesi, true değerinin thinking istediğini, false değerinin thinking çıktısı istemediğini ve bir dizenin modelin tanımladığı bir düzeyi seçtiğini söyler; sayılar desteklenmez. Belgeler, bir modelin desteklediği değerleri bulmak için /api/show kullanılmasını söyler ve araç, think ayarladığınızda bu komutu gösterir. Testimizde think false, qwen2.5:7b ile çalıştı; think true ise "qwen2.5:7b" does not support thinking iletisiyle reddedildi.
format içinde json ile bir JSON Schema arasındaki fark nedir?
API başvuru belgesi, format değerinin json veya bir JSON şeması olabileceğini söyler. json, geçerli herhangi bir JSON ister. Şema ise özellik adları ve hangilerinin zorunlu olduğu gibi tam biçimi tanımlar; testimizde yanıt tam olarak ona uydu. Araç şemayı bir dize olarak değil, bir nesne olarak gönderir.
Bir araç tanımı nasıl görünmeli?
API başvuru belgesi, her zaman function olan type alanını ve bir name ile parameters içeren bir function nesnesini zorunlu kılar; parameters, bağımsız değişkenler için bir JSON Schema'dır; description isteğe bağlıdır. Araç bu alanları denetler. Model işlevi çağırmaya karar verdiğinde yanıt, metin yerine message.tool_calls içerir.
Parolanın arkasındaki bir Ollama'yı nasıl çağırırım?
Vekil sunucunun adresini, örneğin https://ollama.example.com, ve kullanıcı adını girin. Araç curl komutuna bu adla -u ekler, curl da ardından parolayı sorar; böylece parola hiçbir zaman komutun parçası olmaz. Bu sitedeki Ollama nginx Config Generator böyle bir vekil sunucu oluşturur.
Bir sunucuya herhangi bir şey gönderiliyor mu?
Hayır. Araç yalnızca komutu yazar. Siz kendiniz çalıştırana kadar hiçbir şey gönderilmez.
İlgili makaleler
- Küçük bir VPS'te Ollama'nın bellek kullanımını izleyinOllama'nın bellekte neyi tuttuğunu, orada ne kadar kaldığını ve hangi ayarların bunu değiştirdiğini görün: ollama ps, keep_alive ve sınırlar, resmî FAQ'ye göre.
- Dify'ı kendi VPS'inizdeki Ollama'ya bağlayınDify'ı kendi VPS'inizde çalıştırın ve modeli Ollama'dan alın: kurulum, eklenti alanları, Docker adres sorunu ve embedding'ler, resmî belgelere dayanarak.
- Pahalı bir bilgisayar olmadan yerel LLM başlatın: VPS kullanımı için yeni başlayanlara rehberGüçlü bir bilgisayarınız yok mu? Bir VPS kiralayın ve küçük bir yerel LLM'yi tarayıcınızdan çalıştırın: bellek tahmininden korumalı sohbet ekranına altı adım, sınırlar dürüstçe belirtilerek.