Permintaan pertama dalam lima menit
Hubungkan klien yang kompatibel dengan OpenAI Anda ke API tanpa sensor kami dalam hitungan detik. Quickstart ini mencakup konfigurasi dasar, permintaan standar, streaming, dan penggunaan alat dengan model 'tanpa sensor'.
URL Dasar & Autentikasi
Arahkan SDK OpenAI atau klien kompatibel lainnya ke URL dasar kami. Anda tidak memerlukan library khusus; alat apa pun yang menerima kunci API standar berfungsi di sini. Ambil kunci Anda dari dasbor setelah masuk dengan Google atau email. Kunci ditampilkan segera dan merupakan satu-satunya kredensial yang diperlukan untuk semua permintaan.
Atur URL dasar ke https://api.ollamaapi.top/v1. Gunakan ID model uncensored untuk semua penyelesaian chat. Model ini adalah model bobot terbuka, disesuaikan untuk mengurangi penolakan, dan berbeda dari model vendor utama. Ini bukan GPT, Claude, atau model proprietary lainnya. Autentikasi hanya bergantung pada header token Bearer.
Permintaan Pertama
Kirimkan permintaan penyelesaian chat standar untuk menguji konektivitas. Endpoint menerima payload JSON dengan messages, model, dan parameter opsional seperti temperature atau max_tokens. ID model selalu uncensored. Respons mengembalikan JSON terstruktur termasuk konten asisten dan metrik penggunaan token.
Jika permintaan berhasil, Anda menerima respons 200 OK. Jika autentikasi gagal, Anda mendapatkan error 401. Jika Anda tidak memiliki dana, Anda mendapatkan error 402. Error ini gratis, sehingga Anda hanya membayar untuk penggunaan token yang berhasil. Gunakan sampel ini untuk memverifikasi konfigurasi Anda sebelum mengintegrasikannya ke aplikasi Anda.
curl https://api.ollamaapi.top/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."}]
}'
SDK Python
Gunakan pustaka Python resmi OpenAI atau klien kompatibel lainnya. Inisialisasi klien dengan URL dasar dan kunci API Anda. Tetapkan model ke uncensored. Teruskan pesan Anda sebagai daftar kamus yang berisi role dan content. Pustaka menangani serialisasi dan parsing respons secara otomatis.
Respons streaming didukung melalui parameter stream. Ini memungkinkan Anda memproses token saat dihasilkan, yang berguna untuk output panjang atau pembaruan UI waktu nyata. Chunk terakhir berisi total penggunaan token untuk penagihan. Pastikan Anda menangani pengecualian dengan baik, karena error jaringan tidak menimbulkan biaya.
from openai import OpenAI
client = OpenAI(base_url="https://api.ollamaapi.top/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)
SDK Node
Instal paket npm openai atau gunakan pembungkus berbasis fetch. Konfigurasikan klien dengan URL dasar https://api.ollamaapi.top/v1 dan kunci API Anda. ID model tetap uncensored. Teruskan badan permintaan dengan messages dan pengaturan opsional seperti top_p atau seed.
Pengguna Node.js dapat memanfaatkan pola async/await untuk kode yang bersih. Objek respons mencakup choices, usage, dan id. Anda dapat mengekstrak pesan asisten dari pilihan pertama. Penanganan error harus memperhitungkan batas laju (429) dan kredit tidak cukup (402). Error ini tidak mengonsumsi token, sehingga saldo prabayar Anda tetap utuh hingga respons berhasil dihasilkan.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ollamaapi.top/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 mengatur stream: true dalam permintaan Anda. API mengembalikan stream Server-Sent Events (SSE). Setiap chunk berisi konten parsial, memungkinkan Anda menampilkan token saat dihasilkan. Ini mengurangi latensi yang dirasakan pengguna dan meningkatkan pengalaman untuk generasi teks panjang.
Chunk terakhir dalam stream mencakup data penggunaan token lengkap. Anda dapat menggunakannya untuk melacak konsumsi secara real-time. Perhatikan bahwa streaming tidak mengubah model harga; Anda masih membayar per 1M token input dan output. Error selama streaming juga gratis. Jika koneksi terputus, Anda dapat melanjutkan atau memulai ulang permintaan tanpa penalti.
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, Error & Konteks
Jendela konteks adalah 100.000 token secara total, termasuk prompt dan completion. Output maksimum per permintaan adalah 32.000 token (2.048 jika max_tokens tidak diatur). Jika Anda melebihi jendela konteks, permintaan akan gagal. Error meliputi 401 untuk kunci tidak valid, 402 untuk saldo tidak cukup, dan 429 untuk batas laju. Batas laju adalah 300 permintaan per menit dan 8 permintaan paralel per kunci. Badan permintaan dibatasi hingga 8 MB. Error bersifat gratis, artinya Anda tidak membayar untuk permintaan yang gagal atau ditolak. Saldo prabayar tidak pernah habis, dan tidak diperlukan langganan.
Spesifikasi API
Semua batas dan fitur API yang sebenarnya di satu tempat — cek dulu sebelum isi saldo.
| Item | Nilai |
|---|---|
| Format | kompatibel OpenAI: SDK OpenAI apa pun bisa dipakai, cukup ganti base URL dan kunci |
| Base URL | https://api.ollamaapi.top/v1 |
| Autentikasi | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID model | uncensored |
| Output maksimal | hingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah) |
| Mode JSON | response_format: {"type": "json_object"} |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Jendela konteks | 100.000 token (input + output) |
| Batas laju | 300 permintaan per menit per kunci |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Ukuran permintaan | hingga 8 MB |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Masa berlaku | saldo berbayar tidak kedaluwarsa, tanpa langganan |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| 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 |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| Isi saldo | USDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500 |
| Masuk | Google atau email dan kata sandi |
| Kunci | satu kunci aktif per akun; kunci baru menggantikan yang lama |
| Konten | konten 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.
| Kode | Tipe | Arti |
|---|---|---|
400 | bad_request | JSON tidak valid, pesan kosong, parameter salah, atau konteks terlalu panjang |
401 | missing_key · invalid_key · key_revoked | kunci tidak ada, salah, atau sudah diganti |
402 | no_credit | saldo habis — isi ulang dan lanjut seketika |
403 | content_blocked | konten seksual dengan anak di bawah umur — ditolak, tidak ditagih |
404 | not_found | endpoint tidak dikenal |
413 | request_too_large | body lebih dari 8 MB |
429 | rate_limited · concurrency | lebih dari 300/menit atau 8 paralel — tunggu lalu coba lagi |
503 | upstream_busy | model sibuk — coba lagi beberapa detik lagi |
Tanya jawab
Apakah API ini mendukung pemanggilan fungsi?
Ya, API mendukung pemanggilan fungsi melalui parameter <code>tools</code> dan <code>tool_choice</code>. Anda dapat menentukan alat dalam permintaan Anda dan model akan mengembalikan JSON terstruktur untuk penggunaan alat. Fitur ini bekerja dengan semua klien yang kompatibel dengan OpenAI.
Apa yang terjadi jika melebihi jendela konteks?
Jika total token (prompt + completion) melebihi 100.000, permintaan akan gagal dengan error. Error ini gratis, sehingga Anda tidak dikenakan biaya untuk percobaan tersebut. Anda dapat menyesuaikan parameter <code>max_tokens</code> atau memperpendek prompt Anda agar tetap dalam batas.
Apakah kredit uji coba dapat digunakan kembali?
Tidak, kredit uji coba $0,50 berlaku selama 7 hari dan hanya dapat digunakan sekali per akun. Kredit tidak kedaluwarsa setelah digunakan, tetapi jika tidak digunakan, kredit akan hangus setelah 7 hari. Tidak diperlukan kartu kredit untuk mengklaim uji coba.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja pengaturannya.
Dapatkan kunci API