Google: Gemini 2.5 Flash (batch)
Gemini 2.5 Flash adalah model penalaran hibrida stabil Google untuk analisis multimodal dan tugas agen. Anggaran thinking dinamisnya dapat diatur dari 0 hingga 24,576 token, termasuk mode nonaktif. Teks, gambar, audio, video, dan dokumen menjadi teks atau hasil terstruktur, dengan batas masukan 1,048,576 token yang didokumentasikan.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Gemini 2.5 Flash adalah profil penalaran hibrida stabil Google untuk pekerjaan multimodal serbaguna dan penggunaan alat oleh agen. Model ini menawarkan respons dengan dan tanpa thinking untuk tugas multimodal skala besar yang memerlukan tingkat penalaran berbeda. Teks, gambar, audio, dan video berkontribusi pada jawaban teks. Masukan dokumen juga dijelaskan dalam profil cloud khusus model Google. Hasil yang berguna dapat berupa perbandingan dokumen, interpretasi grafik, transkrip, kode, atau rekaman terstruktur.
Kontrol penalaran edisi ini menggunakan thinkingBudget. Thinking dinamis adalah bawaan; pengaturan -1 membiarkan model menyesuaikan penalaran dengan kompleksitas tugas. Anggaran eksplisit dapat berkisar dari nol hingga 24,576 token, dan nol menonaktifkan thinking. Pilih anggaran yang sesuai dengan masalah sebenarnya, alih-alih memberikan upaya yang sama untuk kategorisasi sederhana dan analisis dengan banyak kondisi. Panduan memperlakukan anggaran sebagai arahan, dan kartu asli mencatat bahwa kepatuhan mungkin tidak persis.
Untuk tugas dokumen atau data, definisikan pertanyaan, bidang yang diwajibkan, dan bukti yang harus menyertai hasil. Untuk perbandingan persyaratan, bandingkan dua spesifikasi dan kembalikan persyaratan yang berubah, kutipan sumbernya, serta dampaknya pada alur yang disebutkan. Keluaran terstruktur berguna ketika setiap temuan memerlukan bentuk rekaman yang sama. Jika sumber memberikan beberapa nilai yang mungkin atau membiarkan suatu bidang terbuka, pertahankan ketidakpastian tersebut, alih-alih memaksakan satu jawaban yang tampak masuk akal. Tinjau nilai yang dikembalikan terhadap halaman atau data yang diberikan.
Untuk materi visual atau audio, identifikasi objek, label, peristiwa, atau bagian rekaman yang relevan. Minta jenis teks yang diperlukan: nilai yang terlihat dalam grafik, deskripsi peristiwa, transkrip, atau ringkasan. Artefak tersebut berbeda, dan instruksi harus menyebutkan mana yang dihasilkan. Kartu asli bersama mencakup Flash Image dan Flash Audio sebagai kemampuan dengan nama tersendiri; keluaran gambar dan ucapan yang dihasilkannya bukan bagian dari profil teks stabil ini.
Profil cloud khusus Google mendokumentasikan masukan PDF dan teks biasa dengan batas khusus antarmuka: 50 MB per PDF yang diimpor melalui API dan hingga 3,000 halaman per berkas, dengan batas berkas teks biasa 7 MB. Profil tersebut juga menjelaskan sekitar 45 menit video dengan audio atau satu jam tanpa audio, serta sekitar 8.4 jam audio dalam alokasi masukan satu juta token. Ini adalah batas antarmuka cloud yang dinyatakan, terpisah dari jendela token model umum. Siapkan bagian relevan dan format sumber, alih-alih menganggap setiap jenis berkas atau jalur unggah memiliki batas yang sama.
Tabel khusus Gemini API mencantumkan function calling, eksekusi kode, pencarian berkas, grounding pencarian, grounding Maps, konteks URL, dan keluaran terstruktur. Definisikan peran setiap fungsi dan bentuk parameternya, lalu lanjutkan dari hasil nyata yang dikembalikan. Model dapat meminta operasi, sedangkan aplikasi yang terhubung melaksanakannya. Pertahankan konteks thought signatures yang diperlukan ketika melanjutkan tugas penalaran dalam antarmuka stateless. Jawaban terstruktur atau saran fungsi tidak secara independen membuktikan bahwa operasi eksternal berhasil.
Kartu model asli memberikan konteks 1M dan keluaran teks 64K, sedangkan tabel API khususnya menetapkan 1,048,576 token masukan dan 65,536 token keluaran. Batas respons mencakup token thinking, sehingga batas yang terlalu kecil dapat membuat jawaban akhir terpotong atau kosong. Minta artefak yang ukurannya sesuai dengan alokasi keluaran dan gunakan anggaran penalaran untuk memandu upaya. Caching, batch, serta pemrosesan Flex dan Priority didokumentasikan untuk profil produsen ini. Pertahankan pengenal item ketika menyiapkan beberapa rekaman independen.
Edisi stabil tetap berbeda dari varian Flash Preview dan model Gemini 3 yang lebih baru. Kartunya mencantumkan kemungkinan halusinasi, keterbatasan pemahaman kausal serta penalaran logis kompleks atau kontrafaktual, dan batas pengetahuan Januari 2025. Berikan bukti baru ketika tugas bergantung pada informasi lebih baru. Periksa perhitungan, nilai hasil ekstraksi, transkrip, dan kode yang diusulkan terhadap sumber sebenarnya atau hasil eksekusi. Thinking hibrida berguna ketika mendukung hasil konkret tersebut, bukan menjadi pengganti peninjauannya.
Ailoot Ultra · Batch POST /v1/batches google/gemini-2.5-flash:batch
google/gemini-2.5-flash:batchMulai
Gemini 2.5 Flash adalah model penalaran hibrida stabil Google untuk analisis multimodal dan tugas agen. Anggaran thinking dinamisnya dapat diatur dari 0 hingga 24,576 token, termasuk mode nonaktif. Teks, gambar, audio, video, dan dokumen menjadi teks atau hasil terstruktur, dengan batas masukan 1,048,576 token yang didokumentasikan.
- Masukan yang diterima
- Teks
- Hasil
- Teks
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Batch POST /v1/batches
- Masukan
text- Keluaran
text- Format keluaran
- JSON inline pada results[].response.body
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolomendpoint | Jenisstring | PersyaratanWajib | Nilai & batasan /v1/chat/completions | Bawaan— |
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-2.5-flash:batch | Bawaan— |
Kolomrequests | Jenisbatch_item[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 | Bawaan— |
Kolomrequests[].custom_id | Jenisstring | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomrequests[].body.messages | Jenismessage[] | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomcompletion_window | Jenisstring | PersyaratanOpsional | Nilai & batasan 24h | Bawaan— |
Kolomprovider | Jenisobject|null | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakendpoint, model, requests |
Parametermaterial_types | Kontraktext |
Parameterrepresentation | Kontrakrequests[] inline; setiap item memiliki custom_id dan body |
Parameterrequest_endpoint_profile | Kontrak/v1/chat/completions |
Parameterfile_material | KontrakPemanggil dapat membaca JSONL UTF-8 aktual secara lokal ke dalam requests[]. Tidak menggunakan purpose unggahan, input_file_id, atau referensi file. Materi pelanggan yang tidak ada atau kosong menghentikan persiapan sebelum POST. |
Parameterserialization_order | Kontrakendpoint, model, provider (jika disertakan), completion_window (jika disertakan), requests paling akhir |
Parameteroptional_controls | Kontrakprovider.only, provider.allow_fallbacks, completion_window |
Parameterschema_scope | Kontrakbody teks Chat Completions dalam envelope Batch inline yang didokumentasikan. |
Siklus hidup: asynchronous
GET /v1/batches/{operation_id} · response.id aktual dari operasi create awal; user/key/group yang sama
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
- Harga cache eksplisit
- Tidak diaktifkan Saat cache eksplisit diminta
Tarif Ailoot
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Token konteks, lebih dari | Token konteks, hingga dan termasuk | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Token konteks, lebih dari— | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.0003 / 1K token Keluaran · Token keluaran $0.0025 / 1K token Masukan · Pembacaan cache $0.00006 / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiPanjang permintaan · tingkat 1 | Jadwal tarif— | Token konteks, lebih dari0 | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.0003 / 1K token Keluaran · Token keluaran $0.0025 / 1K token Masukan · Pembacaan cache $0.00006 / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-2.5-flash:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen
def prepare_requests(customer_path):
path = Path(customer_path)
if not path.is_file(): raise ValueError("Customer JSONL file is missing")
items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
if not items: raise ValueError("Customer JSONL contains no requests")
ids = set()
for item in items:
if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
cid = item["custom_id"]
if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
ids.add(cid)
if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-2.5-flash:batch", "requests":items}
if __name__ == "__main__":
material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
body = prepare_requests(material)
key = os.environ.get("AILOOT_API_KEY", "")
if not key: raise SystemExit("Set AILOOT_API_KEY")
request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
with urlopen(request) as response:
raw = response.read()
Path("batch-create-response.json").write_bytes(raw)
print(raw.decode("utf-8"))
Terima dan simpan hasil
Ailoot Ultra · Batch
JSON inline pada results[].response.body
GET /v1/batches/{operation_id}
Periksa status tugas
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.
Simpan setiap hasil, isi respons/kesalahan, pilihan, dan total penggunaan.
Jika respons asli perlu diperiksa
Pertahankan ID operasi asli. 503 result_pending_check memiliki X-Should-Retry:false; jangan pernah kirim ulang batch asli yang statusnya tidak diketahui.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomresults[].custom_id | Jenisstring |
Kolomresults[].response.body.choices[].message.content | Jenisstring|null |
Kolomresults[].error | Jenisobject|null |
Kolomusage | Jenisobject|null |
Alias
Alias model
Ailoot Ultra google/gemini-2.5-flash:batch
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Google: Gemini 2.5 Flash (batch)
- Input dan hasil apa yang tersedia?
POST /v1/batches·google/gemini-2.5-flash:batch:text→text- Kolom apa yang digunakan permintaan?
POST /v1/batches·google/gemini-2.5-flash:batch:endpoint,model,requests,completion_window,provider- Batasan apa yang berlaku?
POST /v1/batches·google/gemini-2.5-flash:batch:requests.min_items:1