Memulai: API Chat Completions

Prasyarat dan URL dasar

API kami sepenuhnya kompatibel dengan antarmuka penyelesaian obrolan OpenAI standar. Anda hanya memerlukan URL dasar dan kunci API untuk mulai mengirim permintaan. URL dasarnya adalah HTTPS://api.howmuchisanapikey.com/v1. Endpoint tunggal ini menangani semua generasi teks tanpa memerlukan Anda mengelola beberapa URL layanan atau konfigurasi proxy.

Autentikasi mudah. Anda harus menyertakan header Authorization dengan skema Bearer diikuti oleh kunci unik Anda. Setiap permintaan ke endpoint chat completions memerlukan header ini untuk memvalidasi akun Anda dan melacak penggunaan token terhadap saldo kredit prabayar Anda.

Autentikasi dan header

Termukkan header Authorization dalam setiap permintaan untuk memverifikasi identitas Anda. Format header adalah Authorization: Bearer YOUR_API_KEY. Jika kunci tidak valid atau kedaluwarsa, API segera mengembalikan error 401. Ini memastikan bahwa hanya akun yang berwenang yang dapat menggunakan kredit prabayar Anda.

Anda tidak perlu meneruskan header tambahan untuk generasi teks dasar. Namun, jika Anda menggunakan fitur tertentu seperti mode JSON atau pemanggilan fungsi, Anda harus mengatur header Content-Type ke application/json. Ini memberi tahu server cara menguraikan badan permintaan Anda dengan benar.

Mengirimkan penyelesaian chat pertama Anda

Kirim permintaan POST ke /v1/chat/completions dengan riwayat pesan dan pengenal model Anda. Model id-nya adalah "uncensored". Model ini di-tune untuk menjawab tanpa penolakan untuk konten dewasa yang sah, fiksi, atau topik kontroversial. Model ini tidak memfilter berdasarkan norma politik atau sosial standar.

Berikut contoh curl dasar untuk memulai:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Respons akan berisi teks yang dihasilkan dalam array choices. Anda dapat menguraikannya langsung ke dalam logika aplikasi Anda. Setiap permintaan mengonsumsi token input untuk prompt Anda dan token output untuk respons model.

Responsi streaming dan penggunaan token

Gunakan Server-Sent Events (SSE) untuk menerima token saat dihasilkan. Ini mengurangi latensi yang dirasakan untuk output panjang. Set parameter stream ke true dalam body permintaan Anda. Server akan mengirim beberapa potongan, masing-masing berisi delta parsial dari respons.

Bagian terakhir mencakup data penggunaan. Objek ini berisi total token input dan output yang dikonsumsi oleh permintaan. Anda dapat menggunakan data ini untuk memperbarui saldo kredit lokal Anda atau memantau pengeluaran Anda secara real-time. Streaming sangat ideal untuk antarmuka obrolan di mana pengguna mengharapkan umpan balik instan.

Pemanggilan fungsi dan mode JSON

API mendukung output terstruktur melalui mode JSON dan pemanggilan fungsi. Atur response_format menjadi {"type": "json_object"} untuk memaksa model mengembalikan JSON yang valid. Ini berguna untuk mengekstrak data atau menghasilkan konfigurasi terstruktur tanpa kesalahan parsing.

Untuk pemanggilan fungsi, berikan array tools dalam permintaan Anda. Model akan merespons dengan tool_calls jika menentukan fungsi diperlukan. Anda kemudian dapat mengeksekusi fungsi dan mengirimkan hasilnya kembali ke model. Ini memungkinkan alur kerja multi-langkah kompleks tanpa logika parsing eksternal.

Menangani batas dan error

Anda dibatasi hingga 300 permintaan per menit per kunci dan 8 permintaan simultan. Jika Anda melebihi batas-batas ini, Anda akan menerima kesalahan 429 Too Many Requests. Badan respons akan menyertakan detail retry-after. Sesuaikan throttling sisi klien untuk menghindari percobaan ulang yang tidak perlu.

Jika kredit prabayar Anda habis, API akan mengembalikan error 402 Payment Required. Anda dapat mengisi ulang melalui kripto kapan saja. Error dan penolakan gratis, jadi Anda hanya membayar untuk generasi token yang berhasil. Jendela konteks adalah 100,000 token untuk prompt dan penyelesaian gabungan.

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.howmuchisanapikey.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.howmuchisanapikey.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);

Streaming

Copystream = 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)