gemini-3.1-flash-lite-imageAPI

Gunakan ID model yang tepat gemini-3.1-flash-lite-image. Bidang model harus sama persis dengan halaman ini.

Contoh keluarangemini-3.1-flash-lite-imagePOST /v1beta/models/gemini-3.1-flash-lite-image:generateContent

Parameter: ratio=16:9

Prompt: A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text.

Permintaan yang menghasilkan sampel ini

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9"
    }
  }
}

Otentikasi dan titik akhir

Gunakan kunci API Modelflare dengan https://modelflare.dev. Titik masuk gateway adalah POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Menghasilkan gambar

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

Minta catatan

Model gambar Gemini menggunakan contents dan generationConfig asli; editan mengirim instruksi teks dan inline_data di parts[] yang sama.

Parameter permintaan

Model gambar Gemini menggunakan Gemini asli generateContent. Letakkan teks dan gambar referensi di contents[].parts[] yang sama; gambar menggunakan inline_data. Jangan kirim model ini ke /v1/images/generations, /v1/images/edits, atau OpenAI /v1/responses. Enum imageSize khusus untuk model dan ditunjukkan di bawah.

Bidang	Wajib diisi	Catatan
contents[].parts[].text	Ya	Perintah teks atau instruksi edit
contents[].parts[].inline_data	Tidak	Data gambar Base64 dan tipe MIME
contents[].parts[].inline_data.mime_type	Tidak	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	Tidak	Konten gambar referensi berkode Base64
generationConfig.responseModalities	Ya	["IMAGE"] atau ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	Tidak	1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
generationConfig.imageConfig.imageSize	Tidak	1K

Batas respons dan masukan

Lite hanya mendukung 1K dengan 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Dokumentasi resmi tidak menerbitkan batas jumlah gambar referensi, sehingga gateway tidak menambahkan batas lokal dan mengembalikan kesalahan layanan ketika batas layanan terlampaui.

Contoh pengeditan gambar

Letakkan instruksi edit dan gambar referensi di contents[].parts[] yang sama. inline_data.data adalah konten gambar Base64; jangan mengirim model gambar Gemini ke Gambar OpenAI atau titik akhir Responses.

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

Bentuk respons

Baca candidates[].content.parts[]; jangan berasumsi setiap bagian adalah gambar karena responsnya mungkin berisi teks dan bagian gambar secara bersamaan.

Bidang	Catatan
candidates[].content.parts[].inline_data	Menghasilkan tipe MIME gambar dan data Base64
candidates[].content.parts[].text	Keterangan teks dikembalikan ketika TEXT diminta
candidates[].finishReason	Alasan penyelesaian atau keamanan
usageMetadata	Penggunaan token input/output saat dikembalikan oleh layanan

Modelflare mempertahankan bentuk respons Gemini asli untuk gemini-3.1-flash-lite-image dan mempertahankan bagian gambar yang dapat digunakan.

Kesalahan dan tugas yang gagal

Kesalahan bidang, batas ukuran/rasio, dan penolakan keamanan dari permintaan Gemini asli tetap menjadi respons kesalahan yang kompatibel dengan Gemini. Gateway tidak menulis ulang gambar tersebut sebagai respons Gambar OpenAI.

Cakupan yang didukung

Halaman ini mencakup pembuatan model Modelflare dan panggilan pengeditan. Pengayaan penelusuran atau peta, pengelolaan suara, dan pengelolaan pustaka elemen merupakan API sumber daya di luar permukaan panggilan model publik ini dan bukan merupakan bidang permintaan yang wajib diisi.

Pricing and billing

Model ini menggunakan penagihan berbasis token. Lihat halaman harga model untuk harga pelanggan saat ini, harga daftar referensi, dan spesifikasi lengkap.

Catatan

Halaman ini mendokumentasikan antarmuka publik Modelflare; bidang dan batasan yang ditampilkan di sini adalah kontrak saat ini.