ID ▾
gemma4api.comDapatkan kunci API

API Gemma: Permintaan pertama dalam lima menit

Dapatkan respons pertama Anda dalam waktu kurang dari lima menit menggunakan SDK OpenAI resmi dengan model tanpa sensor kami. Panduan ini mencakup autentikasi, permintaan dasar, streaming, dan pemanggilan alat dengan gesekan konfigurasi nol.

URL Dasar & Autentikasi

Mulai dengan membuat akun di halaman Dapatkan kunci API. Anda hanya memerlukan email dan kata sandi; tidak diperlukan nomor telepon atau kartu kredit untuk mengaktifkan kredit uji coba gratis. Setelah terdaftar, kunci API Anda ditampilkan segera. Salin kunci ini dan simpan dengan aman. Gunakan dalam header Authorization sebagai token Bearer untuk semua permintaan. URL dasar untuk semua endpoint adalah https://api.gemma4api.com/v1. URL ini berfungsi dengan klien OpenAI-compatible standar apa pun, memungkinkan Anda mengubah penyedia hanya dengan mengubah URL dasar dan kunci API dalam konfigurasi Anda.

Permintaan Pertama

Kirimkan prompt pertama Anda menggunakan curl untuk memverifikasi konektivitas. Ganti YOUR_API_KEY dengan kunci aktual Anda. Pengenal model adalah uncensored. Permintaan teks masuk, teks keluar sederhana ini mengonfirmasi bahwa autentikasi Anda benar dan model merespons. Jika Anda menerima respons JSON dengan array choices, pengaturan Anda telah selesai. Anda sekarang dapat melanjutkan untuk mengintegrasikan SDK untuk alur kerja yang lebih kompleks.

curl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integrasi SDK Python

Instal paket Python OpenAI resmi. Atur variabel lingkungan URL dasar dan kunci API atau teruskan secara langsung ke konstruktor klien. Gunakan ID model uncensored untuk memastikan Anda memanggil instance khusus kami. Pendekatan ini memastikan kode Anda tetap kompatibel dengan pola OpenAI standar sambil memanfaatkan model tanpa sensor kami untuk pembuatan konten. SDK menangani coba ulang dan parsing JSON secara otomatis.

from openai import OpenAI

client = OpenAI(base_url="https://api.gemma4api.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Integrasi SDK Node.js

Untuk lingkungan JavaScript, instal paket Node.js OpenAI. Konfigurasikan klien dengan URL dasar https://api.gemma4api.com/v1 dan kunci API Anda. Gunakan ID model uncensored dalam panggilan penyelesaian Anda. Pengaturan ini memungkinkan Anda mempertahankan struktur kode kompatibel OpenAI standar sambil mendapatkan manfaat dari perilaku model spesifik yang dihosting di server kami. Pastikan Anda menangani respons asinkron dengan benar dalam loop acara Node.js Anda.

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Respons Streaming

Aktifkan streaming dengan menetapkan parameter stream menjadi true dalam permintaan API Anda. Ini mengembalikan aliran Event yang Disajikan Server (SSE), memungkinkan Anda menampilkan token saat dihasilkan. Ini ideal untuk antarmuka obrolan di mana latensi sangat penting. Setiap bagian berisi delta parsial dari respons. Tangani peristiwa akhir aliran untuk mengetahui kapan generasi selesai. Metode ini secara signifikan mengurangi latensi yang dirasakan dibandingkan menunggu respons penuh.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Batas, Kesalahan & Jendela Konteks

Permintaan Anda mendukung jendela konteks 100.000 token untuk prompt dan penyelesaian secara gabungan. Batas laju adalah 300 permintaan per menit per kunci, dengan ukuran badan permintaan maksimum 8 MB. Kesalahan umum termasuk 401 untuk kunci tidak valid, 402 jika saldo prabayar Anda habis, dan 429 jika Anda melebihi batas per menit. Membuat ulang kunci API Anda mencabut kunci lama tetapi tidak mengatur ulang penghitung laju. Pastikan klien Anda menangani kode status HTTP ini dengan tepat untuk menjaga kelancaran operasi.

Spesifikasi teknis

Semua batas dan fitur API yang sebenarnya di satu tempat — cek dulu sebelum isi saldo.

ItemNilai
Formatkompatibel OpenAI: SDK OpenAI apa pun bisa dipakai, cukup ganti base URL dan kunci
AutentikasiAuthorization: Bearer YOUR_KEY
EndpointPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.gemma4api.com/v1
ID modeluncensored
Jendela konteks100.000 token (input + output)
Streamingya — server-sent events; potongan terakhir berisi penggunaan token
Function callingya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool
Output maksimalhingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah)
Mode JSONresponse_format: {"type": "json_object"}
Parametertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Batas laju300 permintaan per menit per kunci
Ukuran permintaanhingga 8 MB
Header responsX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Konkurensi8 permintaan bersamaan per kunci
Harga$0,25 per 1 juta token input · $1,00 per 1 juta token output
Masa berlakusaldo berbayar tidak kedaluwarsa, tanpa langganan
Isi saldoUSDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500
Uji coba gratis$0,50 selama 7 hari, tanpa kartu · Kunci uji coba: 2 permintaan paralel, 60 per menit; batas penuh (8 dan 300) setelah isi saldo pertama
Bonus+5% mulai $50, +10% mulai $100
Penagihansaldo prabayar sesuai pemakaian nyata; error dan penolakan gratis
MasukGoogle atau email dan kata sandi
Kuncisatu kunci aktif per akun; kunci baru menggantikan yang lama
Kontenkonten dewasa diizinkan; konten seksual yang melibatkan anak di bawah umur ditolak

Kode error

Error dikirim sebagai JSON dengan type tetap; permintaan gagal atau ditolak tidak ditagih.

KodeTipeArti
400bad_requestJSON tidak valid, pesan kosong, parameter salah, atau konteks terlalu panjang
401missing_key · invalid_key · key_revokedkunci tidak ada, salah, atau sudah diganti
402no_creditsaldo habis — isi ulang dan lanjut seketika
403content_blockedkonten seksual dengan anak di bawah umur — ditolak, tidak ditagih
404not_foundendpoint tidak dikenal
413request_too_largebody lebih dari 8 MB
429rate_limited · concurrencylebih dari 300/menit atau 8 paralel — tunggu lalu coba lagi
503upstream_busymodel sibuk — coba lagi beberapa detik lagi

Tanya jawab

Apakah membuat ulang kunci API saya akan mereset penghitung batas laju saya?

Tidak. Membuat ulang kunci Anda mencabut kunci sebelumnya dan menerbitkan kredensial baru, tetapi batas laju berlaku per akun dan tetap ada terlepas dari perubahan kunci. Anda harus menunggu jendela menit untuk direset jika Anda mencapai batas 300 permintaan/menit.

Model apa yang berjalan di balik ID 'uncensored'?

Ini adalah model bahasa besar bobot terbuka yang dihosting di server GPU kami sendiri. Ini bukan GPT, Claude, Gemini, atau model vendor lain. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah.

Bisakah saya menggunakan API ini untuk pemanggilan alat?

Ya. Endpoint <code>/v1/chat/completions</code> mendukung pemanggilan alat dan fungsi. Anda dapat meneruskan definisi alat dalam permintaan, dan model akan mengembalikan output JSON terstruktur yang kompatibel dengan implementasi SDK OpenAI standar.

Kunci Anda hanya selangkah lagi dari satu formulir

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

Dapatkan kunci API