ID ▾

API teks tanpa sensor untuk pipa Anda

Cara Menggunakan Alur Kerja API Nano Banana dengan LLM Teks

Situs ini tidak menghasilkan gambar. Ini adalah API LLM OpenAI-compatible text-only yang digunakan orang di samping alat gambar untuk menulis prompt, caption, dan skrip. Berikut cara mengonfigurasinya dan menggunakannya.

Diperbarui

Ilustrasi isometrik kartu teks mengalir menuju bingkai kosong, menunjukkan prompt yang memberi makan alur kerja gambar

Poin kunci

  • API hanya mengembalikan teks: tidak ada pembuatan gambar, audio, atau video.
  • Gunakan base URL https://api.nanobananaapis.com/v1, ID model uncensored, dan kunci Bearer.
  • Penggunaan umum adalah mengubah ide kasar menjadi prompt gambar terstruktur dengan mode JSON.
  • Biaya input $0.15 dan output $0.50 per 1M token, dan permintaan yang gagal gratis.

Baca ini dulu: apa API ini dan apa yang bukan

Jika Anda tiba di sini dengan pertanyaan cara menggunakan API nano banana untuk menghasilkan gambar, jawaban yang jujur adalah layanan ini tidak dapat melakukan bagian itu. "Nano Banana" adalah nama yang umum melekat pada model pembuat gambar, dan pembuatan gambar tidak ditawarkan di sini. Apa yang nanobananaapis.com jual adalah akses ke model bahasa teks melalui endpoint yang kompatibel dengan OpenAI.

Hal itu masih cocok untuk banyak alur kerja gambar, karena alat gambar hanya sebaik teks yang Anda berikan. Model teks dapat menulis prompt, memvariasikannya, memeriksanya terhadap lembar gaya, menghasilkan keterangan dan teks alt, dan menyusun skrip yang menyatukan pipa. Halaman ini membahas penggunaan tersebut. Jika Anda hanya membutuhkan gambar, Anda memerlukan layanan gambar, dan Anda dapat mengaitkannya dengan yang ini.

Model ini adalah model bobot terbuka tunggal, dijalankan oleh penyedia independen, disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi dari vendor besar mana pun. Satu batas keras: tidak ada konten seksual yang melibatkan anak di bawah umur.

Langkah 1: dapatkan kunci

Daftar dengan Google, atau dengan email dan kata sandi, lalu buka halaman kunci API. Anda akan melihat tombol satu klik untuk mengklaim kredit uji coba senilai $0.50. Kredit ini berlaku selama 7 hari, tidak memerlukan kartu, dan dibatasi satu per orang. Kunci uji coba memungkinkan 2 permintaan paralel dan 60 permintaan per menit, yang cukup untuk mencoba-coba.

Salin kunci tersebut dan simpan di luar repositori Anda. Di shell, Anda dapat menyimpannya seperti ini:

export NANOBANANA_KEY="paste-your-key-here"

Langkah 2: kirim permintaan pertama Anda

Tiga nilai penting: base URL, ID model, dan header Authorization. Sisanya mengikuti format chat-completions OpenAI. Berikut panggilan pertama dengan curl:

curl https://api.nanobananaapis.com/v1/chat/completions   -H "Authorization: Bearer $NANOBANANA_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
    ],
    "max_tokens": 200
  }'

Hal yang sama dalam Python dengan paket openai resmi:

import os
from openai import OpenAI

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

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)

Dan di Node:

import OpenAI from "openai";

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

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);

Periksa header respons sekali. X-Balance-USD menunjukkan sisa kredit Anda dan X-Request-Id mengidentifikasi panggilan jika Anda membutuhkan bantuan. Halaman dokumentasi mencantumkan setiap parameter yang didukung.

Langkah 3: ubah ide menjadi prompt terstruktur

Trik paling berguna untuk pipa gambar adalah membuat model mengembalikan data terstruktur alih-alih teks bebas. Mode JSON melakukan hal itu. Anda mendeskripsikan skema dalam pesan sistem, dan balasan langsung diparsing ke dalam kode Anda, sehingga daftar ide kasar menjadi tabel prompt dengan bidang tetap.

import json, os
from openai import OpenAI

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

SYSTEM = (
    "You write prompts for an image model. Reply with JSON only: "
    '{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)

def expand(idea: str, n: int = 3):
    r = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.9,
        messages=[
            {"role": "system", "content": SYSTEM},
            {"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
        ],
    )
    return json.loads(r.choices[0].message.content)["prompts"]

for p in expand("a lighthouse keeper's kitchen in winter"):
    print(p["full"])

Tingkatkan suhu saat Anda menginginkan variasi dan turunkan untuk konsistensi. Parameter seed diteruskan, sehingga Anda dapat menguncinya saat Anda perlu mereproduksi batch sebelumnya. Selalu bungkus json.loads dalam blok try dan minta ulang sekali jika parsing gagal, karena model bahasa apa pun dapat meleset.

Situs ini juga memiliki penjelasan terkait di sisi gambar: pembuatan prompt dan pascapemrosesan. Ini mencakup bagaimana langkah teks terhubung ke generator.

Pekerjaan lain yang dilakukan model teks dengan baik dalam alur kerja gambar

  • Lembar gaya. Simpan satu pesan sistem dengan aturan gaya tetap Anda dan masukkan setiap subjek baru melalui itu, agar seluruh seri tetap konsisten secara visual.
  • Keterangan dan teks alt. Setelah gambar ada, deskripsikan masing-masing gambar tersebut dengan beberapa kata. Berikan deskripsi gambar Anda sendiri sebagai input; model tidak dapat melihat gambar, karena API hanya menerima teks.
  • Daftar bidikan dan skrip. Untuk storyboard atau video pendek, buat daftar adegan, narasi, dan poin penting di layar sebagai teks.
  • Kritik prompt. Tempelkan prompt yang memberikan hasil buruk dan minta tiga penulisan ulang dengan penjelasan perubahannya.
  • Fiksi dan pekerjaan karakter untuk dewasa. Lembar karakter, latar belakang cerita, dan dialog untuk cerita dan aplikasi pendamping, dengan model tidak menolak tema dewasa yang sah.

Untuk pekerjaan panjang, stream output dengan stream: true agar antarmuka pengguna dapat menampilkan teks saat tiba. Pemanggilan fungsi juga didukung, yang memungkinkan model memutuskan kapan memanggil fungsi Anda sendiri, misalnya fungsi yang mengirimkan prompt ke layanan gambar yang Anda gunakan.

Batas dan biaya per eksekusi

Ketahui angka sebelum Anda membangun batch. Kunci penuh memungkinkan 8 permintaan paralel dan 300 permintaan per menit. Jendela konteks adalah 100.000 token mencakup prompt dan penyelesaian, tubuh permintaan maksimum adalah 8 MB, dan max_tokens bersifat opsional. Melebihi batas laju mengembalikan HTTP 429 dengan kode rate_limited atau concurrency; tunggu dan coba lagi.

Harga adalah $0.15 per 1M token input dan $0.50 per 1M token output. Katakan Anda menghasilkan 500 set prompt, masing-masing dengan input 400 token dan output 600 token:

  • Input: 500 x 400 = 200.000 token x $0.15 / 1M = $0.03
  • Output: 500 x 600 = 300.000 token x $0.50 / 1M = $0.15
  • Total: $0.18

Jadi kredit uji coba $0.50 mencakup sekitar 1.300 set berukuran itu. Untuk penggunaan reguler, isi saldo jumlah bulat dari $20 hingga $500, dengan kripto (USDT di TRC20, USDC di Base). Bonus adalah 5% dari $50, 10% dari $100, dan 15% dari $200. Lihat halaman harga untuk tabelnya. Kredit tidak pernah habis.

Mengaitkannya dengan layanan gambar

Pengaturan umum memiliki dua tahap. Tahap teks menggunakan API ini untuk menghasilkan prompt. Tahap gambar mengirimkan prompt tersebut ke generator gambar mana pun yang Anda gunakan, dan generator itu memiliki akun sendiri, harga sendiri, dan aturan sendiri, yang harus Anda baca di situsnya. Pisahkan dua tahap dalam fungsi terpisah, sehingga Anda dapat mengubah salah satu sisi tanpa menulis ulang sisi lainnya.

Tips praktis: simpan setiap prompt bersama dengan seed dan suhu yang Anda gunakan untuk membuatnya. Ketika gambar terlihat bagus, Anda dapat melacaknya kembali ke teks tepat yang menghasilkannya, dan ketika batch mengecewakan, Anda dapat melihat apakah kesalahan terletak pada ide, penulis prompt, atau model gambar. Ini juga memberi Anda cara murah untuk membandingkan dua pesan sistem dengan menjalankan keduanya pada daftar ide yang sama dan menilai dua set prompt secara berdampingan.

Skrip end-to-end kecil

Untuk mengikat potongan-potongan bersama, berikut adalah skrip pendek yang membaca file ide kasar, memperluas setiap satu menjadi prompt dengan mode JSON, dan menulis hasilnya ke file yang dapat dibaca oleh alat gambar Anda. Ini menangani satu mode kegagalan yang akan menggigit Anda: balasan yang bukan JSON valid.

import json, os
from openai import OpenAI

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

def one(idea: str):
    for _ in range(2):
        r = client.chat.completions.create(
            model="uncensored",
            response_format={"type": "json_object"},
            messages=[
                {"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
                {"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
            ],
            max_tokens=250,
        )
        try:
            return json.loads(r.choices[0].message.content)["prompt"]
        except (json.JSONDecodeError, KeyError):
            continue
    return None

ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)

Jalankan pada lima ide terlebih dahulu dan baca hasilnya secara visual. Sesuaikan pesan sistem hingga prompt sesuai dengan gaya yang Anda inginkan, lalu tingkatkan skalanya. Karena setiap permintaan di sini kecil, seribu ide selesai dengan cepat dan biaya sent.

Kesalahan yang sering dilakukan pemula

  • Mengharapkan gambar. Respons selalu teks. Jika kode Anda mencoba menyimpan gambar biner dari balasan, itu akan gagal, karena tidak ada.
  • Mencari nama model lain. Ada satu model, dan ID-nya adalah uncensored. Menyalin nama model vendor dari tutorial memberikan kesalahan tidak ditemukan.
  • Melupakan pesan sistem. Tanpanya, model tidak memiliki panduan gaya dan menyimpang antara prompt pendek dan panjang. Letakkan aturan Anda di sana.
  • Mengirim rahasia dalam prompt. Prompt tidak digunakan untuk pelatihan, tetapi Anda masih harus menghindari menempelkan kata sandi atau kunci pribadi ke input model apa pun.
  • Menjalankan seratus permintaan sekaligus. Kunci penuh memungkinkan 8 sekaligus. Gunakan pool atau semaphore, dan tambahkan retry untuk 429.

Jika sesuatu berperilaku aneh, halaman dukungan adalah tempat untuk bertanya, dan ID permintaan dari header respons membuat pertanyaan jauh lebih mudah dijawab.

Tanya jawab

Apakah API ini dapat menghasilkan gambar Nano Banana?

Tidak. Ini adalah API LLM teks-saja. API ini dapat menulis prompt, caption, dan skrip untuk alur kerja gambar, tetapi tidak menghasilkan gambar, audio, atau video.

Apa yang harus saya masukkan sebagai nama model?

Gunakan uncensored sebagai ID model, dengan Base URL https://api.nanobananaapis.com/v1 dan kunci Anda sebagai token Bearer.

Dapatkah saya mengujinya tanpa membayar?

Ya. Pengguna baru dapat mengklaim kredit uji coba senilai $0.50 dengan satu klik di halaman kunci API. Tidak memerlukan kartu dan berlaku selama 7 hari.

Apakah model melihat gambar saya?

Tidak. Model hanya membaca teks. Jika Anda ingin bantuan terkait gambar, deskripsikan gambar tersebut dalam pesan Anda.

Apakah prompt saya digunakan untuk pelatihan?

Tidak. Prompt tidak digunakan untuk pelatihan.

Kunci Anda hanya selangkah lagi dari satu formulir

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

Dapatkan kunci API