GPT-Image 2.6 Flare dan Sunburst telah hadirMulai $0.025 per gambar
OmniaKey
Masuk

Penyiapan kunci API

Kunci API Nano Banana: dapatkan, atur, dan uji

Sebelum mengatur kunci API Nano Banana, pilih penerbit kuncinya. Cocokkan kunci, URL API, dan ID model. Langkah-langkah berikut mengatur akses melalui OmniaKey.

Kunci resmi penyedia

Untuk kunci yang diterbitkan dan ditagih langsung oleh Google, ikuti petunjuk akun dan kunci API penyedia tersebut.

Buka petunjuk kunci resmi

Kunci API OmniaKey

Gunakan satu saldo dan kunci OmniaKey untuk model yang tersedia bagi akun Anda. Kunci berfungsi dengan endpoint OmniaKey.

Dapatkan kunci API

01Buat kunci API OmniaKey

Masuk, buka API Keys, dan buat kunci untuk aplikasi Anda. Tinjau kuota, masa berlaku, dan pembatasan model. Tambahkan saldo sebelum menjalankan permintaan pembuatan.

Dapatkan kunci API

02Atur kunci dan URL API

Jalankan perintah di terminal Anda sendiri dan ganti placeholder dengan kunci Anda. Simpan kunci di server atau pengelola rahasia. Jangan pernah menaruhnya di kode browser atau repositori publik.

bash / zsh
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Periksa autentikasi

Minta daftar model tanpa memulai tugas pembuatan. Respons yang berhasil berupa JSON dengan array data. Ini memeriksa akses kunci; ini tidak menjamin semua model diaktifkan untuk akun Anda.

GET /v1/models
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Gunakan format permintaan model

Pilih model dari halaman keluarga, salin ID API-nya, dan ikuti dokumentasi API yang sesuai. Autentikasi saja tidak memeriksa parameter pembuatan Anda.

Pembuatan gambar dan video menggunakan POST /v1/media/tasks. Pertahankan Idempotency-Key yang sama saat mencoba ulang pengiriman yang sama, simpan ID tugas yang dikembalikan, dan polling GET /v1/media/tasks/{id} untuk hasilnya.

Contoh permintaan pembuatan (berbayar)

Permintaan ini menggunakan saldo akun Anda. Periksa dulu harga model pilihan. Contoh mengikuti format permintaan yang didokumentasikan; akun Anda tetap memerlukan akses ke model.

POST /v1/media/tasks
curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-first-request-001" \
  -d '{
  "model": "gemini-nano-banana-2.1",
  "type": "image",
  "operation": "generate",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "image_size": "1K",
    "aspect_ratio": "1:1"
  }
}'

Polling tugas media

Ganti YOUR_TASK_ID dengan id yang dikembalikan permintaan pembuatan. Polling hingga tugas mencapai status akhir. Untuk tugas yang berhasil, unduh URL di assets sebelum kedaluwarsa. Gunakan kunci idempotensi baru hanya untuk tugas baru.

GET /v1/media/tasks/{id}
curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"
Baca dokumentasi API

Jika koneksi gagal

  • 401: periksa apakah kunci lengkap, aktif, dan diterbitkan untuk URL API yang Anda panggil.
  • 403: periksa pembatasan model pada kunci dan izin yang tersedia untuk akun Anda.
  • 404 atau HTML alih-alih JSON: periksa host API dan prefiks versi. Gunakan api.omniakey.com, bukan alamat situs web.
  • 429: kurangi konkurensi dan ikuti panduan percobaan ulang pada respons. Jangan terus mengirim ulang tugas pembuatan dengan kunci idempotensi baru.