ID ▾
Dapatkan kunci API

Kunci API Flux: Apa Itu dan Peran API Teks

Kunci API Flux adalah kredensial untuk layanan pembuatan gambar, dan situs ini tidak menjualnya. Yang dijual adalah kunci berbeda untuk API LLM teks yang di-hosting yang dapat menulis dan memperluas prompt yang Anda masukkan ke model gambar.

Diperbarui

Dua kunci terpisah, satu terkait dengan bingkai gambar dan satu lagi dengan gelembung obrolan, dua API terpisah

Poin utama

  • Kunci untuk layanan gambar Flux dan kunci untuk API LLM teks adalah dua hal terpisah, diterbitkan oleh dua penyedia terpisah.
  • Situs ini hanya teks: tidak ada pembuatan gambar, audio, atau video, dan tidak dijalankan oleh vendor model gambar mana pun.
  • Kunci teks berguna di samping kunci gambar karena penulisan prompt adalah tugas teks, yang dibebankan per token.
  • Anda mengubah satu Base URL dan satu kunci di klien OpenAI untuk memulai, dan kredit uji coba mencakup pengujian awal.

Yang biasanya dimaksud orang dengan kunci Flux

Flux adalah nama sekelompok model teks-ke-gambar. Ketika seseorang mengetikkan kunci API flux ke dalam kotak pencarian, mereka hampir selalu menginginkan kredensial yang memungkinkan kode mereka mengirim prompt ke layanan yang menjalankan salah satu model gambar tersebut dan mendapatkan gambar kembali. Kredensial tersebut berasal dari perusahaan yang menjalankan endpoint gambar yang Anda pilih. Kredensial tersebut terkait dengan akun mereka, penagihan mereka, dan ketentuan mereka.

Anda akan melihat frasa ini digunakan dalam beberapa cara yang sedikit berbeda, dan membantu untuk mengurutkannya sebelum Anda menempelkan kunci di mana pun:

  • Kunci dari host gambar yang melayani model Flux, digunakan dalam permintaan yang mengembalikan gambar.
  • Kunci untuk pengaturan lokal atau self-hosted, di mana Anda membuat token sendiri dan tidak ada yang keluar dari mesin Anda.
  • Kunci untuk alat lain dalam pipeline Anda, seperti model teks yang menulis prompt, yang hanya disebut Flux karena proyeknya bernama demikian.

Hanya dua yang pertama yang menghasilkan gambar. Yang ketiga adalah tempat situs ini berada. Kami menjalankan API LLM yang kompatibel dengan OpenAI, dan kunci yang Anda dapatkan di sini berfungsi terhadap API tersebut dan tidak ada yang lain.

Mengapa kunci gambar tidak dapat memanggil model obrolan

Dua jenis kunci terlihat mirip, karena keduanya adalah string panjang yang Anda kirimkan dalam header Authorization, tetapi mereka membuka pintu yang berbeda. Kunci penyedia gambar diperiksa oleh penyedia gambar. Jika Anda mengirimkannya ke endpoint obrolan, Anda akan mendapatkan kesalahan autentikasi, dan sebaliknya juga benar: kunci dari situs ini akan mengembalikan kesalahan jika Anda mengirimkannya ke host gambar.

Isi permintaan juga berbeda. Panggilan gambar biasanya membawa prompt, dimensi, seed, dan jumlah gambar. Panggilan obrolan membawa daftar pesan dengan role, dan mengembalikan teks. Tidak ada skema bersama, sehingga tidak ada yang perlu diterjemahkan di antara keduanya. Jika Anda memiliki skrip yang berfungsi dengan host gambar, pertahankan skrip tersebut dan kuncinya persis seperti adanya. Tambahkan panggilan teks sebagai langkah terpisah di depannya.

Apa yang tidak dilakukan layanan ini

Untuk menjaga ekspektasi tetap jelas: API di sini hanya teks. API ini tidak menghasilkan gambar, audio, atau video, tidak membuat embedding, dan tidak menawarkan fine-tuning. Ini bukan API resmi dari vendor model mana pun dan bukan router antar vendor. API ini melayani satu model bobot terbuka, yang telah di-tune untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, dan dijalankan oleh penyedia independen. ID model yang Anda berikan adalah uncensored.

Di mana API teks berada di samping kunci gambar

Penulisan prompt adalah titik pertemuan yang jelas. Model gambar merespons dengan baik terhadap deskripsi spesifik dan terstruktur: subjek, latar, lensa, pencahayaan, warna, suasana hati. Sebagian besar orang menulisnya secara manual, lalu menulis ulang setelah hasil yang buruk. Model teks dapat membuat draf pertama, memperluas ide tiga kata menjadi deskripsi lengkap, atau menghasilkan dua puluh variasi pada tema saat Anda pergi mengambil kopi.

Beberapa pekerjaan yang cocok:

  • Ekspansi. Ubah ide pendek menjadi prompt terperinci dalam gaya yang Anda tetapkan sekali di pesan sistem.
  • Variasi. Minta sepuluh pendekatan berbeda pada satu subjek, dikembalikan sebagai daftar JSON yang dapat diiterasi skrip Anda.
  • Pembersihan. Tulis ulang prompt berantakan yang ditulis oleh pelanggan menjadi sesuatu yang lebih mudah ditangani oleh model gambar.
  • Skrip dan keterangan. Tulis narasi, daftar shot, atau keterangan yang akan disertakan di samping gambar.

Karena model di sini tidak menolak secara default, model ini cocok untuk fiksi, desain karakter, dan tema dewasa yang sering ditolak oleh model yang di-hosting lain, selama penggunaannya sah dan melibatkan orang dewasa. Satu batas keras berlaku di mana-mana: tidak ada konten seksual yang melibatkan anak di bawah umur. Permintaan seperti itu bukan sesuatu yang kami dukung dalam bentuk apa pun.

Permintaan pertama dalam waktu kurang dari satu menit

Setiap SDK OpenAI atau klien HTTP berfungsi setelah Anda mengganti Base URL dan kunci. Endpoint untuk obrolan adalah POST /v1/chat/completions, dan GET /v1/models menampilkan model. Berikut adalah permintaan yang sama dalam curl dan Python.

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)

String apa pun yang dikembalikan adalah apa yang Anda berikan ke layanan gambar Anda, menggunakan kunci layanan tersebut. Keduanya tidak pernah saling terhubung. Untuk daftar lengkap parameter, termasuk streaming, pemanggilan fungsi, dan mode JSON, lihat dokumentasi API.

Apakah Anda memerlukan kedua kunci?

Tergantung pada apa yang sedang Anda bangun. Tabel di bawah ini adalah cara cepat untuk memutuskan.

Tujuan AndaKunci gambarKunci teks
Hasilkan gambar dari prompt yang Anda tulis sendiriYaTidak
Hasilkan gambar dari prompt yang ditulis atau diperluas oleh modelYaYa
Tulis hanya cerita, dialog, atau skripTidakYa
Bangun aplikasi obrolan atau roleplay untuk orang dewasaTidakYa
Produksi batch ratusan variasi promptOpsionalYa

Jika Anda hanya mengetik prompt sendiri dan merasa puas dengan hasilnya, kunci teks memberikan sedikit nilai tambah. Jika Anda mendapati diri menulis ulang prompt sepanjang sore, atau membutuhkan volume besar, kunci ini akan segera menutupi biayanya. Kami juga memiliki panduan singkat tentang menggunakan LLM teks dalam alur kerja video, yang mengikuti gagasan yang sama tentang langkah teks di depan langkah media.

Kesalahan yang muncul dari kebingungan kunci

Sebagian besar masalah dalam pengaturan dua layanan adalah kecil dan mudah dikenali setelah Anda tahu apa yang harus dicari.

  • Base URL yang salah. Jika klien Anda masih menunjuk ke host lama, kunci baru akan ditolak. Periksa bahwa Base URL berakhir dengan /v1 dan cocok dengan yang ada di contoh di atas.
  • Nama model yang salah. Satu-satunya ID model di sini adalah uncensored. Melewati nama model gambar akan mengembalikan kesalahan, karena tidak ada model seperti itu di API ini.
  • Kunci dalam satu variabel lingkungan. Berikan setiap layanan variabelnya sendiri, misalnya TEXT_API_KEY dan IMAGE_API_KEY. Berbagi satu nama adalah bagaimana kunci berakhir dikirim ke host yang salah.
  • Mengharapkan gambar dalam balasan. Responsnya adalah teks biasa di choices[0].message.content. Jika Anda membutuhkan gambar, teks itu harus dikirim ke layanan gambar Anda sebagai panggilan kedua.
  • Mengabaikan 429. Lonjakan di atas 8 permintaan paralel mengembalikan 429 dengan kode kesalahan concurrency, dan di atas 300 permintaan per menit dengan rate_limited. Mundur sebentar dan coba lagi. Permintaan streaming memegang slotnya hingga stream selesai, jadi tutup stream yang tidak Anda baca lagi.

Kunci uji coba memiliki batas yang lebih rendah: 2 permintaan paralel dan 60 per menit. Itu cukup untuk menguji langkah penulisan prompt secara manual, tetapi batch besar harus menunggu kunci yang telah di-top up.

Biaya penulisan prompt

Penagihan dihitung per token dan bersifat prabayar: $0,15 per 1 juta token input dan $0,50 per 1 juta token output, tanpa langganan. Pekerjaan prompt bersifat kecil, sehingga biayanya juga kecil. Ambil satu permintaan dengan pesan sistem dan ide (input) berukuran 600 token serta prompt yang diperluas (output) berukuran 250 token. Biaya input adalah 600 / 1.000.000 x $0,15 = $0,00009. Biaya output adalah 250 / 1.000.000 x $0,50 = $0,000125. Satu permintaan sebesar $0,000215.

Jadi satu batch 1.000 permintaan seperti itu harganya sekitar $0,215. Kredit uji coba $0,50, yang dapat Anda klaim dengan satu klik di halaman kunci setelah pendaftaran, mencakup sekitar 2.300 permintaan di antaranya (0,50 / 0,000215). Tidak memerlukan kartu dan berlaku selama 7 hari. Permintaan yang gagal atau ditolak tidak dikenakan biaya, dan saldo yang Anda tambahkan nanti tidak akan pernah kedaluwarsa. Detailnya ada di halaman harga.

Mendapatkan kunci teks Anda

Daftar menggunakan Google, atau dengan email dan kata sandi, lalu buka halaman kunci API. Klaim kredit uji coba di sana jika Anda ingin menguji terlebih dahulu. Isi saldo berbayar dimulai dari $20 hingga $500 dalam jumlah bulat, dengan bonus +5% dari $50, +10% dari $100, dan +15% dari $200. Anda dapat membayar dengan kripto (USDT pada TRC20, USDC pada Base).

Jauhkan kunci dari kode sisi klien dan dari repositori publik. Prompt yang Anda kirim tidak digunakan untuk pelatihan, tetapi kunci yang bocor akan menghabiskan saldo Anda. Kunci penuh memungkinkan 8 permintaan paralel dan 300 permintaan per menit, sehingga batch prompt dapat dijalankan secara paralel tanpa usaha tambahan.

Tanya jawab

Bisakah saya menggunakan kunci ini untuk menghasilkan gambar dengan Flux?

Tidak. Kunci ini hanya berfungsi pada API teks situs ini. Pembuatan gambar memerlukan kunci dari penyedia yang menghosting model gambar.

Apakah ini API Flux resmi?

Tidak. Ini adalah API teks yang kompatibel dengan OpenAI, dihosting secara independen, dengan satu model bernama uncensored. Model ini tidak dijalankan oleh vendor model gambar mana pun dan tidak menjual kembali layanan mereka.

Bisakah model teks menulis prompt untuk alat gambar saya?

Ya. Minta prompt dalam pesan sistem, ambil teks balasan, dan tempel atau kirim ke layanan gambar Anda. Kedua layanan tetap independen.

Apakah saya perlu kartu untuk mencobanya?

Tidak. Pengguna baru dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik di halaman kunci, berlaku selama 7 hari, tanpa perlu kartu.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah Base URL. Itu saja seluruh proses pengaturannya.

Dapatkan kunci API