TR ▾

MiniMax API Kurulumu: Anahtar, Base URL ve İlk İstek

Bu, minimaxapikey.com üzerinde OpenAI uyumlu API için adım adım kurulum rehberidir: hesap, anahtar, base URL, ilk istek. Bu, herhangi bir model satıcısının resmi API'si olmayan bağımsız bir hizmettir.

Güncellendi

Bir anahtardan bir sunucu rafına uzanan, API kurulum yolunu temsil eden altı parlak adım

Temel noktalar

  • Google veya e-posta ile kaydolun, ardından anahtar sayfasında $0,50 deneme kredisi talep edin. Kart gerekmez.
  • Base URL https://api.minimaxapikey.com/v1, model ID'si uncensored, kimlik doğrulama Bearer anahtarıdır.
  • İki yöntem vardır: POST /v1/chat/completions ve GET /v1/models.
  • 401 hatalı bir anahtarı, 429 ise bir limite ulaşıldığını gösterir; bu nedenle yanıt gövdesindeki hata kodunu kontrol edin.

Kurulumunuz

İnsanlar minimax api kurulumu araması yaparak iki şeyden birini bekler: resmi MiniMax geliştirici platformu veya OpenAI tarzı bir uç nokta. Bu sayfa ikincisini kapsar. minimaxapikey.com arkasındaki servis, bağımsız bir sağlayıcı tarafından işletilen, tek bir açık ağırlıklı modelle çalışan barındırılmış bir OpenAI uyumlu metin API'sidir. MiniMax'in veya başka herhangi bir model sağlayıcısının resmi API'si değildir ve istekleri sağlayıcılar arasında yönlendirmez. Sağlayıcının kendi platformuna ihtiyacınız varsa, onların sitesini kullanın.

Elde edeceğiniz şey basittir. Base URL'yi ve anahtarı değiştirdiğinizde herhangi bir OpenAI SDK'sı veya istemcisi çalışır. İki yöntem (POST /v1/chat/completions ve GET /v1/models), bir model ID (uncensored) ve istem ile tamamlama için paylaşılan 100.000 token'lık bağlam penceresi vardır. Sadece metin destekler; görüntü, ses veya video üretimi, embeddings ve ince ayar (fine-tuning) yoktur. Streaming, tool calling ve JSON modu desteklenir.

Tüm kurulum birkaç dakika sürer. Aşağıdaki adımlar sırayla ilerler ve her biri, ilerlemeden önce çalıştığını bildiren bir kontrolle biter.

Adım 1 ve 2: hesap oluşturun ve deneme sürümünü talep edin

  1. Anahtar sayfasını açın. API anahtarı sayfasına gidin ve kayıt olun. Google veya bir e-posta adresi ile şifre kullanabilirsiniz.
  2. Deneme kredisi talep edin. Kayıttan sonra, anahtar sayfasında $0,50 deneme kredisi için bir düğme bulunur. Tek tıklama ile yapılır, kart gerektirmez, 7 gün geçerlidir ve kişi başı bir kezle sınırlıdır.

Deneme sürümü kasıtlı olarak küçüktür. 1M girdi token başına $0.15 ve 1M çıktı token başına $0,50 fiyatla, $0,50 iyi sayıda test isteğini karşılar. 1.000 tokenlik bir istem ve 500 tokenlik bir yanıt, girdi için $0.00015 ve çıktı için $0.00025 maliyetinde olur, bu da $0,0004 eder. $0,50'yi buna böldüğünüzde 1.250 böyle istek alırsınız, bu da deneyimlemek için bolca alan bırakır.

Deneme anahtarı limitlerini not edin: 2 eşzamanlı istek ve dakikada 60 istek. Bakiye yükledikten sonra elde edeceğiniz tam anahtar dakikada 8 eşzamanlı istek ve 300 istek izni verir. Test döngünüz eşzamanlı çalışıyorsa ve 429 hataları görürseniz, kontrol edilecek ilk şey budur.

Adım 3: anahtarı oluşturun ve güvenli bir şekilde saklayın

Aynı sayfada bir API anahtarı oluşturun ve kopyalayın. Onu bir şifre gibi ele alın. Bir ortam değişkenine veya gizli bilgi yöneticisine (secrets manager) koyun, bir depoda, ön uç paketinde veya bir ekran görüntüsünde asla bırakmayın. Bir anahtar sızarsa, onu kaldırın ve yeni bir tane oluşturun.

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

Sunucu tarafı kodu değişkeni çalışma zamanında okumalıdır. Tarayıcı kodu anahtarı asla elinde tutmamalıdır: istekleri arka ucunuzdan gönderin, çünkü tarayıcıya gönderilen her şey her ziyaretçi için görünürdür.

Adım 4: anahtarı onaylamak için modelleri listeleyin

En ucuz test, models uç noktasıdır. Metin üretmez, bu nedenle anahtar, URL ve ağınız için temiz bir kontroldür.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

uncensored içeren bir JSON listesi almalısınız. 401 alırsanız, anahtar yanlış veya etrafında boşluk veya tırnak karakteri vardır. Bağlantı başarısız olursa, URL'nin /v1 ile bittiğinden ve https kullandığınızdan emin olun.

Adım 5: ilk sohbet isteğini gönderin

Şimdi gerçek bir tamamlama. Gövde standart sohbet tamamlama biçimindedir.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

Yanıt choices[0].message.content ve istem ile tamamlama token sayıları içeren bir usage bloğu içerir. curl -i ile yanıt başlıklarına da bakın. Destek ekibinin isteğinizi bulması için kullanabileceği X-Request-Id, kalan kredinizi gösteren X-Balance-USD ve hız limiti başlıkları X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency göreceksiniz.

temperature, top_p, stop, seed gibi parametreler ve penalty parametreleri iletilir. max_tokens isteğe bağlıdır. Bu parametreyi belirtmezseniz, tamamlama işlemi pencerede kalan her şeyi kullanabilir.

Adım 6: aynı çağrıyı bir SDK'dan yapın

curl çalıştıktan sonra, aslında kullanacağınız dile geçin. Stok bir OpenAI kurulumundan yalnızca iki argüman değişir.

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.minimaxapikey.com/v1",
    api_key=os.environ["UNCENSORED_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.minimaxapikey.com/v1",
  apiKey: process.env.UNCENSORED_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

Streaming için stream: true ekleyin ve sunucu tarafından gönderilen olayları (SSE) okuyun. Kullanım istatistikleri akışın sonunda iletilir. dokümantasyon sayfası streaming, tool calling ve response_format: {"type":"json_object"} ile JSON modunu kapsar.

Mevcut bir OpenAI projesini taşıma

Çoğu zaman bağlanmak istediğiniz proje zaten OpenAI istemci kütüphanesiyle çalışır. Bu durumda kodu neredeyse hiç düzenlemeniz gerekmez. Resmi SDK'lar, argüman geçmediğinizde OPENAI_API_KEY ve OPENAI_BASE_URL ortam değişkenlerini okur, bu nedenle bir dağıtım değişikliği yeterli olabilir.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

Kalan tek düzenleme model adını değiştirmektir. OpenAI model ID'si gibi bir dize burada mevcut olmayacaktır; onu uncensored ile değiştirin (tercihen geri geçiş yapabileceğiniz bir yapılandırma değeri üzerinden). Ardından hizmetin sunmadığı özellikler için kodu inceleyin. Görüntü üretimi, ses, embeddings ve ince ayar (fine-tuning) mevcut değildir; bu metin tabanlı bir sohbet API'sidir. Uygulamanız arama için embeddings çağırıyorsa, bu kısım için başka bir sağlayıcıya ihtiyacınız olacaktır ve sohbet için bu hizmeti kullanmaya devam edebilirsiniz.

Modelin ne olduğunu bilmek de yardımcı olur. Yetişkinlerin yasal kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmış tek bir açık ağırlıklı modeldir ve ayarlardan bağımsız olarak bir katı sınır geçerlidir: reşit olmayanları içeren cinsel içeriğe izin verilmez. Başka bir model için yazılan istemler, her model aynı sistem istemine farklı tepki verdiği için küçük ayarlamalar gerektirebilir. Gerçek trafiği geçirmeden önce kendi test istemlerinizi yan yana çalıştırın.

İlk günde seçilmeye değer ayarlar

Bazı kararlar lansmandan sonra değil, kurulum sırasında vermek daha kolaydır. Hiçbiri zor değildir, ancak her biri daha sonra sürprizleri önler.

  • Bir sistem istemi. Ton, biçim ve rol hakkındaki talimatlarınızı bir system mesajına koyun. Kısa ve spesifik tutun, çünkü her istek onu girdi tokenları olarak tekrarlar.
  • Bir token sınırı. max_tokens isteğe bağlıdır, ancak bir sınır ucuz bir koruma sağlar. Bir sınır olmadan tek bir yanıt 100.000 tokenlik pencerenin kalanını kullanabilir.
  • Etkileşimli kullanım için akış. Bir kişi yanıtı bekliyorsa stream: true ayarlayın. Toplu işler için normal istekler daha basittir.
  • 429 için bir yeniden deneme kuralı. 429'u bir hata olarak değil, bekleme sinyali olarak değerlendirin. Yanıt Retry-After: 5 içeriyorsa, o kadar beklemek ve yeniden denemek doğru harekettir.
  • İstek boyutu. Gövde sınırı 8 MB'tır. Bu, normal bir istemin ihtiyacından çok daha fazlasıdır, ancak yapıştırılan günlükler veya belgeler buna ulaşabilir.

İstemler eğitim için kullanılmaz, bu da iç belgeler veya kullanıcı mesajları göndermeyi planlıyorsanız önemlidir. Gönderdiklerinizden siz sorumlusunuz, bu nedenle modele ihtiyacı olmayan gizli bilgileri bir isteme koymayın.

Deneme sonrası bakiye yükleme

Deneme, her şeyin çalıştığını kontrol etmek içindir. Geliştirmeye hazır olduğunuzda ön ödemeli kredi ekleyin. Abonelik yoktur: kullandığınız token'lar için ödeme yaparsınız. 1M girdi token'ı başına $0,15, 1M çıktı token'ı başına $0,50 ödersiniz. Kredi süresi dolmaz; bu nedenle kullanılmayan bakiye ay sonunda kaybolmaz.

$20 ile $500 arasındaki herhangi bir tam miktar çalışır. $50 bakiye yükleme %5 bonus ekler, $100 %10 ekler ve $200 %15 ekler. Hızlı bir örnek olarak, %10 bonuslu $100 bakiye yükleme $110 kredi verir. Adım iki'deki 1.000 tokenlik istem ve 500 tokenlik yanıt ile her istek $0,0004 eder, bu nedenle $110 275.000 isteği karşılar. Gerçek istemler genellikle daha uzundur, bu nedenle bu rakamı kendi ortalamanıza göre ölçeklendirin.

Yaygın kurulum hatalarını düzeltme

BelirtiOlası nedenÇözüm
Her çağrıda 401Eksik, yanlış yazılmış veya iptal edilmiş anahtarAuthorization: Bearer <key> gönderin, ekstra tırnak olmadan
404 veya HTML yanıtıYanlış yol, genellikle eksik /v1/v1 ile biten tam base URL'yi kullanın
Model bulunamadıBaşka bir sağlayıcıdan kopyalanan bir model adıuncensored kullanın
rate_limited ile 429Dakika başı istek sınırının üzerine çıkmakYavaşlayın veya deneme limitlerinden tam limitlere geçmek için bakiye yükleyin
concurrency ile 429Aynı anda çok fazla istekEşzamanlı çağrıları 8'e kadar sınırlandırın (deneme anahtarında 2)
429 ile Retry-After: 5Geçici aşırı yüklenme5 saniye bekleyin ve yeniden deneyin
413 veya gövde reddedildiİstek 8 MB'ı aşıyorİstemi kısaltın veya işi bölün

Deneme limitlerini aşmaya hazır olduğunuzda, fiyatlandırma sayfası bakiye yükleme seçeneklerini listeler: $20 ile $500 arasında herhangi bir tam tutar; kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödenir. $50'den itibaren %5 bonus, $100'den itibaren %10 ve $200'den itibaren %15 bonus uygulanır. Başarısız veya reddedilen istekler için ücret alınmaz ve istemler eğitim için kullanılmaz.

Sorular ve cevaplar

Bu resmi MiniMax API mi?

Hayır. Bağımsız, barındırılan, OpenAI uyumlu bir API'dir ve tek bir açık ağırlıklı modeli sunar; yetişkinlerin yasal kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır. Herhangi bir model tedarikçisinin resmi API'si değildir ve tedarikçiler arasında bir yönlendirici değildir.

Denemek için kredi kartına ihtiyacım var mı?

Hayır. Kayıt olduktan sonra API anahtarı sayfasında tek bir tıklamayla $0,50 deneme kredisi talep edebilirsiniz. 7 gün boyunca geçerlidir ve kişi başı bir kezle sınırlıdır.

İsteklerde hangi model adı kullanılmalı?

uncensored modelini kullanın. Hizmet bu tek model kimliğini sunar ve GET /v1/models bunu gösterecektir.

Daha sonra nasıl daha fazla kredi eklerim?

$20 ile $500 arasında herhangi bir tam tutarı yükleyin. Bonuslar $50'den (+%5), $100'den (+%10) ve $200'den (+%15) itibaren uygulanır ve kredi asla sona ermez.

OpenAI SDK'sını kullanabilir miyim?

Evet. base_url'yi https://api.minimaxapikey.com/v1, olarak ayarlayın, anahtarınızı kullanın ve model olarak uncensored gönderin. Kodunuzdaki başka hiçbir şeyi değiştirmeniz gerekmez.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al