# curl: terminalden LLM API

> OpenAI uyumlu bir LLM API için terminal tarifleri: curl ve jq ile bir chat completion, dosyadan bir istek, streaming, model listesi ve kalan kredi.

- URL: https://llmwithcrypto.com/tr/docs/curl/
- Son güncelleme: 2026-10-23
- Yayıncı: LLMwithCrypto (https://llmwithcrypto.com)

Her çağrı, JSON gövdesiyle düz HTTPS'tir, bu yüzden bir anahtarı test etmek, iki modeli karşılaştırmak veya hızlı bir işi betikleştirmek için curl yeterlidir. `jq` JSON'u okunur hale getirir; ikisi de çoğu sistemle birlikte gelir veya tek komutla kurulur.

**Kısa yanıt — LLMwithCrypto ile curl kullanarak nasıl çağrı yaparım?**

`https://llmwithcrypto.com/api/v1/chat/completions` adresine `-H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"`, bir JSON content type ve `model` ile `messages` içeren bir gövdeyle bir POST gönderin. **LLMwithCrypto** OpenAI yanıt nesnesini döndürür; yanıtı ve token sayılarını yazdırmak için `jq` ile boru hattına verin. Metnin canlı olarak geldiğini görmek için `-N` ve `"stream": true` ekleyin; 23 Ekim 2026 tarihinde belgelendiği şekliyle.

## Anahtarı bir kez nasıl ayarlarım?

Her komutun kullanabilmesi için shell oturumunuzda export edin ve shell geçmişinizden ve paylaşılan betiklerden uzak tutun:

- **Linux ve macOS:** terminalde `export LLMWITHCRYPTO_API_KEY=…` veya betiklerinizin yüklediği ve asla commit edilmeyen bir `.env` dosyasında.
- **Windows PowerShell:** `$env:LLMWITHCRYPTO_API_KEY = "…"`, ardından komutları Git Bash veya WSL'de çalıştırın ya da tırnak kullanımını uyarlayın.

Her uygulama, agent veya ekip arkadaşı için bir API anahtarı oluşturun ve dashboard'dan diğerlerine dokunmadan herhangi birini iptal edin.

*Kısa bir yanıt ve token sayıları*

```bash
curl -s "https://llmwithcrypto.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-oss-20b", "messages": [{"role": "user", "content": "One word for fast?"}], "max_tokens": 20}' \
  | jq -r '.choices[0].message.content, "\(.usage.prompt_tokens) in, \(.usage.completion_tokens) out"'

```

## Tırnak sorunlarından nasıl kaçınırım?

Gövdeyi bir dosyaya koyun. Bir istem kesme işareti veya dolar işareti içerdiği anda shell tırnakları ile JSON tırnakları birbirine girer; bir dosya ikisini de önler. `--data @request.json` dosyayı olduğu gibi gönderir.

*Dosyadan okunan bir istek*

```bash
cat > request.json <<'EOF'
{
  "model": "deepseek-v4-pro",
  "messages": [
    {"role": "system", "content": "You review shell scripts."},
    {"role": "user", "content": "Is it safe to run rm -rf \"$DIR\"/ when DIR may be empty?"}
  ],
  "max_tokens": 300
}
EOF
curl -s "https://llmwithcrypto.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" \
  -H "Content-Type: application/json" \
  --data @request.json | jq -r '.choices[0].message.content'

```

## Akış halinde gelen bir yanıtı nasıl izlerim?

`-N` curl'ün çıktı tamponunu kapatır, böylece her sunucu tarafından gönderilen olay geldiği anda yazdırılır. Ham `data:` satırlarını görürsünüz; [akış sayfası](https://llmwithcrypto.com/tr/docs/streaming/) bunları açıklar.

*Akış halinde gelen yanıt, ham olaylar*

```bash
curl -sN "https://llmwithcrypto.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Write a haiku about latency."}],
    "stream": true,
    "stream_options": {"include_usage": true},
    "max_tokens": 120
  }'

```

## Modelleri nasıl listelerim ve krediyi nasıl kontrol ederim?

Her iki çağrı da ücretsizdir. İlki her satırda bir model kimliği yazdırır, `model` alanı için hazırdır; ikincisi kalan krediyi ABD doları cinsinden yazdırır.

*Model kimlikleri*

```bash
curl -s "https://llmwithcrypto.com/api/v1/models" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" | jq -r '.data[].id'

```

*Kalan kredi*

```bash
curl -s "https://llmwithcrypto.com/api/v1/credits" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" | jq -r '.balance_usd'

```

## Terminalde bir hatayı nasıl görürüm?

Gövdeden sonra durum kodunun yazdırılması için `-w "\nHTTP %{http_code}\n"` ekleyin. Hata gövdesi, `code` alanı içeren küçük bir JSON nesnesidir; örneğin `invalid_api_key`, `insufficient_balance` veya `model_not_found`; [hatalar sayfası](https://llmwithcrypto.com/tr/docs/errors/) her birini açıklar. `jq` ile, `.error.code // empty` varsa kodu yazdırır, yoksa hiçbir şey yazdırmaz; bu da betiklerde dallanmayı kolaylaştırır.

Hatalar ücretsizdir. Token başına bakiyenizden ödersiniz: girdi ve çıktı token'ları modelin kendi tokenizer'ı ile sayılır ve o modelin 1M token başına fiyatından ücretlendirilir. Hata ile sonuçlanan bir çağrı ücretsizdir.

## curl ile toplu işlem betikleştirebilir miyim?

Birkaç istek için, dosyalar üzerinde bir shell döngüsü uygundur: her dosya için bir JSON gövdesi, her dosya için bir curl, sonuçlar yanlarına yazılır. Rate limit'inizin altında kalmak için sıralı çalıştırın veya `xargs -P 4` ile aynı anda birkaçını çalıştırın. Her hesabın dashboard'da gösterilen bir dakika başına istek ve token limiti vardır; destek ekibine sorun, yükseltilebilir.

Daha büyük her şey için, yeniden denemeler ve eşzamanlılık kodda daha kolaydır: [Python](https://llmwithcrypto.com/tr/docs/python/) ve [Node.js](https://llmwithcrypto.com/tr/docs/node/) sayfalarında eşzamanlılık sınırı olan hazır toplu örnekler vardır.

## curl: sık sorulan sorular

### Neden 401 hatası alıyorum?

Anahtar eksik, yanlış yazılmış veya iptal edilmiş ya da değişken bu shell'de tanımlı değil. Boş olmadığını kontrol etmek için `echo ${#LLMWITHCRYPTO_API_KEY}` çalıştırın.

### İki modeli hızlıca nasıl karşılaştırırım?

Aynı dosyayı iki kez çalıştırın ve yalnızca `model` değiştirin, örneğin `deepseek-v4-pro` ve `gpt-oss-120b`; `usage` satırları her yanıtın token cinsinden maliyetini gösterir.

### Prompt'um saklanıyor mu?

Hayır. Prompt'larınızı veya modelin yanıtlarını saklamayız: bir yanıt gönderildiğinde metni kaybolur. Her çağrı, zaman, hesap, model ve token sayılarını içeren tek bir log satırı bırakır; bu satırlar 30 gün sonra silinir.

---

LLMwithCrypto: LLMwithCrypto, açık ağırlıklı modeller için OpenAI uyumlu bir LLM API'sidir — DeepSeek V4 Pro, DeepSeek V4.1 Flash, DeepSeek R1, Qwen3.5 397B A17B, Qwen3 235B A22B Instruct, gpt-oss-120b, gpt-oss-20b, GLM-4.7, Llama 3.3 70B Instruct, Gemma 4 31B, Mistral Large 3, Mistral Small 4 — ön ödemeli kripto bakiyesinden token başına ödenir ve genel barındırıcıların medyan fiyatının %5 altındadır. KYC yok: kimlik yok, selfie yok, belge yok. İstemler ve çıktılar saklanmaz.