Panduan Cepat API Dolphin AI

URL Dasar dan Autentikasi

Autentikasi memerlukan satu kunci API yang dikirim di Authorization header.

Setiap permintaan harus menargetkan URL dasar https://api.dolphinaisincensura.com/v1 dan sertakan kunci sebagai Bearer YOUR_API_KEY.

Konfigurasi ini berfungsi dengan SDK yang kompatibel dengan OpenAI apa pun hanya dengan memperbarui base_url konfigurasi.

Kesalahan seperti 401 menunjukkan kunci tidak valid atau hilang, sedangkan 402 menandakan kredit prabayar tidak cukup.

Copycurl https://api.dolphinaisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python imports for requests and json"}]
  }'

Mengirimkan Penyelesaian Chat

Kirim permintaan POST ke /v1/chat/completions dengan model field set to uncensored.

Termasuk sebuah messages array yang berisi riwayat prompt Anda untuk mempertahankan konteks percakapan.

API mengembalikan respons teks langsung di content field of the first choice.

Pendekatan model tunggal ini menghilangkan biaya proxy dan memastikan harga yang prediktif sebesar $0.15 per 1M token input.

Copyfrom openai import OpenAI

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

Menangani Streaming (SSE)

Aktifkan streaming dengan mengatur stream ke true dalam payload permintaan Anda.

Server merespons dengan Server-Sent Events (SSE) yang mengirimkan token secara bertahap.

Parse setiap potongan SSE untuk mengekstrak teks yang dihasilkan tanpa menunggu respons penuh.

Statistik penggunaan token disediakan dalam potongan terakhir stream untuk penagihan yang akurat.

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)

Pemanggilan Fungsi dan Mode JSON

Gunakan tools parameter untuk mendefinisikan skema fungsi untuk ekstraksi data terstruktur.

Atur response_format ke {"type": "json_object"} untuk memaksa output JSON yang ketat agar parsing andal.

Spesifikkan temperature dan top_p untuk mengontrol kreativitas versus determinisme dalam hasil Anda.

Fitur ini memungkinkan Anda membangun agen otonom yang berinteraksi dengan API atau basis data eksternal.

Copyimport OpenAI from "openai";

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

Memahami Batas Token dan Context

Jendela konteks mendukung 100.000 token untuk gabungan prompt dan completion.

Output maksimum per permintaan adalah 16.000 token, atau 2.048 jika max_tokens tidak diatur.

Batas laju mengizinkan 300 permintaan per menit dan 8 permintaan konkurensi per kunci API.

Permintaan melebihi batas body 8 MB atau mencapai batas konkurensi mengembalikan error 429.

Respons kesalahan dan penolakan tidak menguras kredit prabayar Anda.

Batas Laju dan Konvergensi

Setiap kunci API dibatasi hingga 300 permintaan per menit dan 8 koneksi simultan aktif.

Kode status 429 menunjukkan bahwa Anda telah melebihi batas konkurensi atau batas laju ini.

Anda dapat membuat kunci baru untuk menggantikan yang ada, tetapi hanya satu kunci aktif yang diizinkan per akun.

Pantau penggunaan Anda melalui header respons untuk tetap berada dalam batas body permintaan 8 MB.