TR ▾
API anahtarı al

Flux API Anahtarı: Nedir ve Metin API'si Nerede Yer Alır

Bir Flux API anahtarı, bir resim oluşturma hizmeti için kimlik bilgisidir ve bu site bir tane satmaz. Sattığı şey, bir görüntü modeline besleyeceğiniz istemleri yazmak ve genişletmek için kullanılabilecek, barındırılan bir metin LLM API'si için farklı bir anahtardır.

Güncellendi

İki ayrı anahtar: biri görsel çerçevesine, diğeri sohbet balonlarına bağlı; iki ayrı API

Temel noktalar

  • Bir Flux görsel servisi için bir anahtar ile bir metin LLM API'si için bir anahtar, iki ayrı sağlayıcı tarafından verilen iki ayrı şeydir.
  • Bu site yalnızca metin içerir: resim, ses veya video oluşturma yoktur ve herhangi bir görüntü modeli satıcısı tarafından işletilmez.
  • Bir metin anahtarı, istem yazımı token başına ücretlendirilen bir metin görevi olduğu için görsel anahtarının yanında kullanışlıdır.
  • Herhangi bir OpenAI istemcisinde temel URL'yi ve anahtarı değiştirerek başlayabilirsiniz; deneme kredisi ilk testleri kapsar.

Genellikle Flux anahtarı ile kastedilen

Flux, metinden-görsel modeller ailesinin adıdır. Birisi arama kutusuna flux api key yazdığında, neredeyse her zaman kodlarının, bu görsel modellerden birini barındıran bir servise bir istem gönderip resim almasını sağlayan bir kimlik bilgisi ister. Bu kimlik bilgisi, seçtiğiniz görsel uç noktasını işleten şirketten gelir. Onların hesabına, faturalandırmasına ve şartlarına bağlıdır.

İfadeyi birkaç farklı şekilde görebilirsiniz ve anahtarı herhangi bir yere yapıştırmadan önce bunları ayırt etmek faydalıdır:

  • Flux modellerini sunan bir görsel sağlayıcıdan, görsel döndüren bir istekte kullanılan bir anahtar.
  • Yerel veya kendi kendine barındırılan bir kurulum için bir anahtar; token'ı kendiniz oluşturursunuz ve hiçbir şey makinenizden dışarı çıkmaz.
  • İstemleri yazan metin modeli gibi iş akışınızdaki başka bir araç için anahtar; proje bu şekilde adlandırıldığı için yalnızca Flux olarak adlandırılır.

Yalnızca ilk ikisi resim üretir. Üçüncüsü, bu sitenin bulunduğu yerdir. Barındırılan, OpenAI ile uyumlu bir LLM API'si işletiyoruz ve burada aldığınız anahtar yalnızca bu API ile çalışır.

Neden bir görsel anahtarı sohbet modelini çağıramaz

İki anahtar türü benzer görünür, çünkü ikisi de Authorization başlığında gönderilen uzun dizelerdir, ancak farklı kapılar açarlar. Bir görsel sağlayıcısının anahtarı görsel sağlayıcısı tarafından kontrol edilir. Bunu bir sohbet uç noktasına gönderirseniz kimlik doğrulama hatası alırsınız ve tam tersi de geçerlidir: bu siteden bir anahtar, bir görsel sağlayıcısına gönderildiğinde hata döndürür.

İstek gövdeleri de farklıdır. Bir resim çağrısı genellikle bir istem, boyutlar, bir seed ve resim sayısını içerir. Bir sohbet çağrısı ise rolleri olan bir mesaj listesini içerir ve metin döndürür. Ortak bir şema olmadığı için bunlar arasında çevrilecek bir şey yoktur. Bir resim sunucusuyla çalışan bir betiğiniz varsa, betiği ve anahtarını olduğu gibi koruyun. Metin çağrısını önüne ayrı bir adım olarak ekleyin.

Bu hizmetin yapmadığı şeyler

Beklentileri net tutmak için: API yalnızca metindir. Görsel, ses veya video oluşturmaz, embedding oluşturamaz ve ince ayar sunmaz. Herhangi bir model satıcısının resmi API'si değildir ve satıcılar arasında bir yönlendirici değildir. Yasal yetişkin kullanımı için içerik reddi olmadan cevap vermeye ayarlanmış tek bir açık ağırlıklı modeli sunar ve bağımsız bir sağlayıcı tarafından işletilir. İleteceğiniz model kimliği uncensored'dir.

Metin API'si bir görsel anahtarının yanında nerede yer alır

İstem yazımı, açık bir buluşma noktasıdır. Görsel modeller belirli, yapılandırılmış betimlemelere iyi yanıt verir: konu, ortam, lens, aydınlatma, renk, ruh hali. Çoğu insan bunları elle yazar, ardından kötü bir sonuçtan sonra yeniden yazar. Bir metin modeli ilk taslağı yapabilir, üç kelimelik bir fikri tam bir betimlemeye genişletebilir veya siz kahve almaya giderken bir tema etrafında yirmi varyasyon üretebilir.

İyi uyan birkaç görev:

  • Genişletme. Kısa bir fikri, sistem mesajında bir kez ayarladığınız bir stilde ayrıntılı bir isteme dönüştürün.
  • Varyasyon. Bir konu üzerinde on farklı yorum isteyin; betiğinizin üzerinde döngü kurabileceği bir JSON listesi olarak döndürülsün.
  • Temizleme. Bir müşteri tarafından yazılmış dağınık bir istemi, bir görsel modelin daha iyi işleyebileceği bir şeye yeniden yazın.
  • Betikler ve altyazılar. Resmin yanına gidecek anlatımı, çekim listesini veya altyazıyı yazın.

Buradaki model varsayılan olarak reddetmediği için, diğer barındırılan modellerin genellikle reddettiği kurgu, karakter tasarımı ve olgun temalar için uygundur, kullanım yasal ise ve yetişkinleri kapsıyorsa. Her yerde geçerli bir katı sınır vardır: reşit olmayanları içeren cinsel içeriğe izin verilmez. Bu tür istekler, herhangi bir biçimde desteklediğimiz bir şey değildir.

Bir dakikadan kısa sürede ilk çağrı

Temel URL'yi ve anahtarı değiştirdikten sonra herhangi bir OpenAI SDK'sı veya HTTP istemcisi çalışır. Sohbet için uç nokta POST /v1/chat/completions'dir ve GET /v1/models modeli listeler. İşte curl ve Python ile aynı istek.

curl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
      {"role": "user", "content": "a lighthouse in a storm, painterly"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
        {"role": "user", "content": "a lighthouse in a storm, painterly"},
    ],
)
print(reply.choices[0].message.content)

Dönen her dizeyi, o hizmetin kendi anahtarını kullanarak görsel hizmetinize iletirsiniz. İkisi birbirine asla dokunmaz. Akış, fonksiyon çağırma ve JSON modu dahil tüm parametreler için API belgeleri'ne bakın.

Her iki anahtara da ihtiyacınız var mı?

Ne inşa ettiğinize bağlıdır. Aşağıdaki tablo, karar vermenize yardımcı olacak hızlı bir yoldur.

HedefinizGörsel anahtarıMetin anahtarı
Kendiniz yazdığınız istemlerden resim oluşturunEvetHayır
Bir modelin yazdığı veya genişlettiği istemlerden resim oluşturunEvetEvet
Yalnızca hikaye, diyalog veya senaryo yazınHayırEvet
Yetişkinler için sohbet veya rol yapma uygulaması oluşturunHayırEvet
Yüzlerce istem varyasyonunu toplu olarak üretinİsteğe bağlıEvet

Yalnızca kendi istemlerinizi yazarsanız ve onlardan memnunsanız, bir metin anahtarı çok az şey ekler. Tüm öğleden sonra istemleri yeniden yazmakla uğraşıyorsanız veya hacim gerekiyorsa, maliyetini hızla karşılar. Ayrıca, bir medya adımından önce gelen bir metin adımının aynı fikrini takip eden video iş akışlarında metin LLM kullanma hakkında kısa bir rehberimiz de var.

Anahtarların karıştırılmasından kaynaklanan hatalar

İki hizmetli kurulumlardaki sorunların çoğu, neye bakmanız gerektiğini bildiğinizde küçük ve kolayca fark edilebilir.

  • Yanlış base URL. İstemciniz hala eski host'a işaret ediyorsa, yeni anahtar reddedilir. Base URL'nin /v1 ile bittiğinden ve yukarıdaki örnekle eşleştiğinden emin olun.
  • Yanlış model adı. Burada tek model kimliği uncensored'dir. Bir görsel modelin adını geçirmek hataya neden olur, çünkü bu API'de böyle bir model yoktur.
  • Bir ortam değişkenindeki anahtarlar. Her hizmete kendi değişkenini verin, örneğin TEXT_API_KEY ve IMAGE_API_KEY. Tek bir adı paylaşmak, bir anahtarın yanlış host'a gönderilmesine neden olur.
  • Yanıttan resim bekleme. Yanıt, choices[0].message.content'de düz metindir. Bir resme ihtiyacınız varsa, bu metin ikinci bir çağrı olarak görsel servisinize gitmelidir.
  • 429'ı görmezden gelme. 8 eşzamanlı istek üzerindeki bir dalga, concurrency hata koduyla 429 döndürür ve dakika başına 300 istek üzeri rate_limited ile döndürür. Kısa bir süre bekleyip yeniden deneyin. Akışlı bir istek, akış bitene kadar slotunu tutar; okumadığınız akışları kapatın.

Deneme anahtarı daha düşük limitlere sahiptir: 2 eşzamanlı istek ve dakikada 60. Bu, bir istem yazma adımını manuel olarak test etmek için fazlasıyla yeterlidir, ancak büyük bir toplu işlem için bakiyesi yüklenmiş bir anahtar beklemelidir.

İstem yazmanın maliyeti

Faturalandırma token başına ve ön ödemelidir: 1M giriş token'ı başına $0,15 ve 1M çıktı token'ı başına $0,50, abonelik yoktur. İstem işleri küçüktür, bu nedenle sayılar küçüktür. 600 token'lık bir sistem mesajı ve fikir (giriş) ile 250 token'lık genişletilmiş bir istem (çıktı) içeren bir istek alın. Giriş maliyeti 600 / 1.000.000 x $0,15 = $0,00009'dur. Çıktı maliyeti 250 / 1.000.000 x $0,50 = $0,000125'tir. Bir istek $0,000215'tir.

Böyle 1.000 isteklik bir toplu işlem yaklaşık $0,215'e mal olur. Kayıt olduktan sonra anahtar sayfasında tek tıkla talep edebileceğiniz $0,50'lik deneme kredisi bunlardan yaklaşık 2.300'ünü karşılar (0,50 / 0,000215). Kart gerekmez ve 7 gün geçerlidir. Başarısız veya reddedilen istekler için ücret alınmaz ve daha sonra eklediğiniz kredi süresi dolmaz. Detaylar fiyatlandırma sayfasında yer alır.

Metin anahtarınızı alma

Google ile veya e-posta ve şifre ile kaydolun, ardından API anahtarı sayfasını açın. Önce test etmek istiyorsanız deneme kredisini oradan talep edin. Ücretli bakiye yükleme $20 ile $500 arasında herhangi bir tam miktarda çalışır, $50'den itibaren +%5 bonus, $100'den itibaren +%10 ve $200'den itibaren +%15 bonus. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz.

Anahtarı istemci kodunun ve genel depoların dışında tutun. Gönderdiğiniz istemler eğitim için kullanılmaz, ancak sızan bir anahtar kredinizi harcar. Tam anahtar 8 eşzamanlı istek ve dakikada 300 istek izni verir, böylece bir istem toplu işlemi ekstra iş olmadan paralel olarak çalışabilir.

Sorular ve cevaplar

Bu anahtarı Flux ile görüntü oluşturmak için kullanabilir miyim?

Hayır. Anahtar yalnızca bu sitenin metin API'si ile çalışır. Görüntü oluşturma için bir görüntü modeli barındıran bir sağlayıcıdan anahtar gerekir.

Bu resmi Flux API mi?

Hayır. Bu, tek bir modele sahip, bağımsız, barındırılan ve OpenAI uyumlu bir metin API'sidir; modelin adı uncensored'dir. Bir görüntü modeli sağlayıcısı tarafından işletilmez ve onların hizmetlerini yeniden satmaz.

Metin modeli resim aracım için istemler yazabilir mi?

Evet. Sistem mesajında bir istem isteyin, yanıt metnini alın ve resim hizmetinize yapıştırın veya gönderin. İki hizmet bağımsız kalır.

Denemek için bir karta ihtiyacım var mı?

Hayır. Yeni kullanıcılar anahtar sayfasında tek tıkla 7 gün geçerli $0,50 deneme kredisi alabilir; kart 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