OpenAI Uyumlu cURL İstek Oluşturucu

OpenAI uyumlu API nedir?

Birçok LLM sağlayıcısı ve kendi barındırdığı çıkarım sunucusu — OpenAI'nin kendisi, Azure OpenAI, Groq, OpenRouter, Together AI, Mistral, DeepSeek, vLLM, llama.cpp sunucusu, LM Studio ve Ollama'nın OpenAI uyumlu modu — OpenAI tarafından yaygınlaştırılan aynı REST arayüzünü sunar: /v1/chat/completions gibi uç noktalara gönderilen JSON istekleri, Authorization başlığında bir Bearer token ile kimlik doğrulaması yapar. Bu sayede entegrasyon kodunuzu yeniden yazmadan sağlayıcıları değiştirebilirsiniz.

Bu uç noktalar için doğru bir cURL komutunu elle yazmak; özellikle temperature ve penalty gibi örnekleme parametrelerini ayarlarken veya chat, eski completions ve embeddings istekleri arasında geçiş yaparken URL'nin, başlıkların ve JSON gövdesinin tam olarak doğru olmasını gerektirir.

Araç açıklaması

Bu araç, OpenAI uyumlu tüm API'ler için kullanıma hazır cURL komutları oluşturur. Temel URL'yi, uç noktayı, modeli ve parametreleri ayarlayın; terminalinize veya betiklerinize yapıştırmaya hazır, düzgün biçimlendirilmiş bir cURL komutunu anında alın.

Örnekler

Chat completion:

curl -X POST "https://api.openai.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -d '{
  "model": "gpt-4o-mini",
  "messages": [
    { "role": "system", "content": "Yararlı bir kodlama asistanısınız." },
    { "role": "user", "content": "Bir stringi tersine çevirmek için bir Python işlevi yazın" }
  ],
  "temperature": 0.3,
  "stream": false
}'

Kendi barındırdığınız sunucu (vLLM, llama.cpp, LM Studio, ...):

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -d '{
  "model": "llama-3-8b-instruct",
  "messages": [
    { "role": "user", "content": "Hamlet oyununun konusunu iki cümleyle özetleyin" }
  ],
  "stream": true
}'

Embeddings:

curl -X POST "https://api.openai.com/v1/embeddings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -d '{
  "model": "text-embedding-3-small",
  "input": "Çevik kahverengi tilki tembel köpeğin üzerinden atlar"
}'

Özellikler

• En yaygın üç OpenAI uyumlu uç noktayı destekler: /chat/completions, /completions ve /embeddings
• Herhangi bir uyumlu temel URL ile çalışır; bu nedenle OpenAI, Azure, Groq, OpenRouter, Together AI ve kendi barındırdığınız sunucular için uygundur
• Yapılandırılabilir örnekleme parametreleri: temperature, top-p, frequency penalty, presence penalty, maksimum token sayısı, completion sayısı, durdurma dizileri ve seed
• Chat completion istekleri için isteğe bağlı JSON nesnesi yanıt biçimi
• Hiçbir şey herhangi bir yere gönderilmez — cURL komutu tamamen tarayıcınızda oluşturulur ve API anahtarınız makinenizden hiçbir zaman ayrılmaz

Seçeneklerin açıklaması