ID ▾
Dapatkan kunci API

Endpoint API Kompatibel OpenAI: Apa yang Didukung

Daftar endpoint API kompatibel OpenAI yang didukung layanan ini, dengan permintaan yang berfungsi untuk masing-masing dan daftar jelas apa yang hilang.

Diperbarui

Poin utama

  1. Lima jalur: penyelesaian obrolan, respons, model dan dua rute saldo.
  2. ID model adalah uncensored, dan satu kunci berfungsi dengan SDK OpenAI apa pun.
  3. Tidak ada gambar, audio, video, embedding, atau fine-tuning.
  4. Batas laju mengembalikan HTTP 429 dengan kode kesalahan yang jelas.
Pusat komando dengan lima kabel, satu untuk setiap endpoint API yang didukung

Endpoint sekilas

Jalur bergaya OpenAI mana yang benar-benar diimplementasikan oleh penyedia? Berikut adalah daftar singkat untuk API ini. URL dasar: https://api.uncensoredendpoint.com/v1. Autentikasi adalah kunci bearer pada setiap panggilan.

Metode dan jalurTujuan
POST /v1/chat/completionsPermintaan obrolan, streaming, alat, mode JSON
POST /v1/responsesFormat permintaan bergaya Responses yang lebih baru
GET /v1/modelsMenampilkan model; ID-nya adalah uncensored
GET /v1/dashboard/billing/credit_grantsSaldo dalam bentuk bergaya OpenAI
GET /v1/balanceSaldo dalam bentuk sederhana

Itu saja seluruh permukaannya. Apa pun yang tidak ada di tabel tidak ditawarkan. Terus baca untuk permintaan yang berfungsi dan daftar apa yang hilang, agar Anda dapat merencanakan di atasnya sebelum menulis kode.

Penyelesaian obrolan

Ini adalah endpoint yang paling banyak digunakan klien. Arahkan SDK OpenAI apa pun ke URL dasar dan gunakan nama model uncensored.

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "List three uses of a webhook."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Parameter yang didukung termasuk stream, tools, tool_choice, response_format dengan json_object, dan parameter sampling: temperature, top_p, stop, seed serta penalti. max_tokens bersifat opsional, karena penyelesaian dapat menggunakan sisa jendela 100.000 token.

Dengan stream: true, balasan tiba sebagai peristiwa dikirim server dan penggunaan disertakan di akhir, sehingga Anda masih dapat mencatat jumlah token.

Obrolan multi-gilir

API tidak menyimpan keadaan percakapan. Untuk obrolan multi-gilir, Anda mengirim daftar pesan lengkap setiap kali: pesan sistem terlebih dahulu, kemudian giliran pengguna dan asisten secara bergantian. Itu berarti token masukan bertambah setiap kali, dan begitu pula biayanya, jadi potong atau rangkum giliran lama sekali percakapan menjadi panjang. Jendela tersebut adalah 100.000 token untuk prompt ditambah penyelesaian, yang cukup untuk sebagian besar obrolan tetapi mudah terisi dengan dokumen yang ditempelkan.

Respons, model dan saldo

Respons

Contoh OpenAI yang lebih baru menggunakan /v1/responses. Ini juga tersedia di sini, sehingga kode yang ditulis untuk format tersebut tidak perlu ditulis ulang.

curl https://api.uncensoredendpoint.com/v1/responses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "input": "Write a haiku about caching."}'

Gunakan whichever yang diharapkan oleh klien Anda. Jika Anda memulai dari awal, kelengkapan obrolan memiliki dukungan alat terluas.

Model dan saldo

Daftar model untuk memeriksa apakah kunci Anda berfungsi. Anda harus melihat satu entri, uncensored, karena layanan menjalankan satu model dan bukan router lintas vendor.

curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"

# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"

# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"

Anda juga mendapatkan saldo pada setiap respons di header X-Balance-USD, yang berguna untuk peringatan kredit rendah di aplikasi Anda tanpa permintaan tambahan. Header lain termasuk X-Request-Id untuk pertanyaan dukungan, serta X-RateLimit-Limit-Requests dan X-RateLimit-Limit-Concurrency.

Alat dan mode JSON dalam praktik

Dua fitur mengubah endpoint obrolan menjadi sesuatu yang dapat Anda bangun sebagai produk. Pemanggilan fungsi memungkinkan model meminta kode Anda untuk menjalankan fungsi. Mode JSON membuatnya mengembalikan output yang dapat diuraikan. Keduanya menggunakan bidang permintaan standar.

Panggilan alat terlihat seperti ini. Model mengembalikan entri tool_calls, Anda menjalankan fungsi, dan Anda mengirim hasilnya kembali sebagai pesan dengan role: "tool".

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)

Untuk mode JSON, tambahkan response_format={"type": "json_object"} dan sebutkan dalam prompt bahwa Anda menginginkan JSON, idealnya dengan kunci yang Anda harapkan. Selalu uraikan di dalam blok try: tidak ada model yang menjamin skema Anda pada setiap panggilan, jadi validasikan hasilnya sebelum Anda mempercayainya.

Memindahkan proyek OpenAI yang ada

Jika aplikasi Anda sudah menggunakan SDK OpenAI, migrasi memerlukan tiga pengeditan dan tidak ada pustaka baru. Sebagian besar SDK membaca dua variabel lingkungan yang sama, sehingga Anda sering kali dapat tidak mengubah apa pun dalam kode sama sekali.

export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEY
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);

Kemudian cari kode Anda untuk nama model seperti ID model GPT dan ganti dengan uncensored, karena layanan memiliki satu model. Hapus panggilan ke embedding, gambar, atau audio, dan alihkan ke penyedia lain. Simpan daftar periksa singkat: URL dasar berubah, nama model berubah, kunci disimpan dalam variabel lingkungan dan bukan di repositori, logika ulang untuk 429, dan peringatan saldo rendah berdasarkan header saldo. Untuk pengaturan kunci, lihat cara mendapatkan kunci API AI tanpa sensor. Kemudian jalankan permintaan uji tunggal dan periksa apakah X-Balance-USD kembali, sebelum Anda mengalihkan lalu lintas nyata.

Apa yang tidak ditawarkan

Mengetahui kesenjangan tersebut menghemat satu hari debugging. API ini hanya teks. Endpoint OpenAI berikut tidak tersedia:

  • Gambar dan visi. Tidak ada pembuatan atau pengeditan gambar.
  • Audio. Tidak ada suara-ke-teks atau teks-ke-suara.
  • Video. Tidak ditawarkan.
  • Embeddings. Jika Anda membangun pengambilan, Anda memerlukan layanan embedding terpisah.
  • Fine-tuning. Anda tidak dapat melatih di layanan.

Panggilan ke jalur tersebut akan gagal, jadi jauhkan dari konfigurasi klien bersama apa pun. Penyiapan tipikal menggabungkan API ini untuk obrolan dengan penyedia lain untuk embeddings, dan aplikasi Anda memilih base URL per tugas.

Batas, error, dan retry

Kunci penuh memungkinkan 8 permintaan paralel dan 300 permintaan per menit. Kunci uji coba memungkinkan 2 permintaan paralel dan 60 per menit. Body maksimum adalah 8 MB. Ketika Anda melampaui batas, Anda mendapatkan HTTP 429 dengan kode kesalahan yang menyatakan mana yang dilampaui: rate_limited untuk permintaan per menit, concurrency untuk terlalu banyak permintaan sekaligus. Saat kelebihan beban sementara, Anda juga mendapatkan 429, dengan header Retry-After: 5.

Satu detail menjebak orang: permintaan yang dialirkan memegang slot konkurensinya hingga stream berakhir, sehingga pembaca lambat dihitung terhadap batas. Pembungkus ulang sederhana menangani semua ini:

import time
from openai import OpenAI, RateLimitError

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

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))
    raise RuntimeError("still rate limited")

Permintaan yang gagal atau ditolak tidak dibebankan biaya, sehingga retry pada kesalahan tidak menambah biaya. Untuk pekerjaan batch, batasi kumpulan pekerja Anda di 8 pada kunci penuh, atau 2 pada kunci uji coba, alih-alih mengandalkan retry. Kumpulan tetap lebih mudah untuk dipahami, dan itu menjaga satu aliran lambat dari memblokir yang lain.

Biaya dan akses

Harga adalah $0,15 per 1M token masukan dan $0,50 per 1M token keluaran, dari saldo prabayar tanpa langganan dan tidak pernah berakhir. Isi saldo dengan jumlah bulat apa pun dari $20 hingga $500, dengan kripto (USDT pada TRC20, USDC pada Base). Top-up yang lebih besar menambahkan bonus: +5% dari $50, +10% dari $100, +15% dari $200. Lihat halaman harga.

Untuk mencobanya, daftar dengan Google atau email, lalu klaim kredit uji coba $0,50 dengan satu klik di halaman kunci API. dokumentasi mencakup setiap parameter, dan ringkasan endpoint menjelaskan apa layanan ini: satu model bobot terbuka untuk penggunaan dewasa yang sah, tanpa penolakan konten dan larangan tegas pada konten seksual yang melibatkan anak di bawah umur.

Tanya jawab

Apakah mendukung streaming dan pemanggilan alat?

Ya. Gunakan stream: true untuk peristiwa dikirim server dengan penggunaan di akhir, dan alat dengan tool_choice untuk pemanggilan fungsi.

Apakah ada endpoint embeddings?

Tidak. Layanan ini hanya untuk obrolan teks, jadi gunakan penyedia lain untuk embeddings.

Bagaimana cara memeriksa saldo saya?

Panggil GET /v1/balance atau jalur credit_grants bergaya OpenAI, atau baca header X-Balance-USD pada setiap respons.

Apa yang terjadi ketika saya mencapai batas laju?

Anda mendapatkan HTTP 429 dengan kode rate_limited atau concurrency. Tunggu dan coba lagi; saat kelebihan beban sementara, header Retry-After menunjukkan 5 detik.

Kunci Anda hanya selangkah lagi dari satu formulir

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

Dapatkan kunci APIBaca dokumentasi