Panduan Awal API Dolphin AI

URL Dasar & Autentikasi

Mulai dengan mengatur URL dasar dan kunci API Anda dalam konfigurasi klien. Semua permintaan diautentikasi melalui Authorization header menggunakan kunci unik Anda. Layanan kami bertindak sebagai penyedia independen untuk dolphin ai openrouter varian model, artinya Anda tidak memerlukan akun di OpenRouter untuk menggunakan endpoint ini. Cukup ambil kunci Anda dari dasbor dan masukkan ke variabel lingkungan Anda.

• URL Dasar: https://api.openrouterdolphinai.com/v1
• Header: Authorization: Bearer YOUR_API_KEY

Konfigurasi ini berfungsi dengan SDK OpenAI standar apa pun karena kami meniru struktur endpoint mereka secara persis. Anda hanya akan berinteraksi dengan endpoint chat completions, menjaga integrasi Anda tetap sederhana dan fokus pada generasi teks.

Permintaan Pertama

Kirim pesan pertama Anda untuk menghasilkan teks menggunakan POST metode. ID model selalu uncensored, yang memastikan Anda mendapatkan varian uncensored yang disesuaikan untuk dialog tanpa batasan. Anda tidak perlu menentukan parameter routing yang kompleks karena kami menghosting model tunggal ini secara langsung.

Gunakan perintah curl berikut untuk menguji koneksi Anda segera:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

Jika Anda menerima respons JSON dengan konten, kunci Anda aktif dan kredit dikurangkan dengan benar. Error seperti 401 menunjukkan kunci tidak valid, sedangkan 402 berarti Anda perlu mengisi ulang melalui kripto. Pendekatan langsung ini menghindari variabilitas dari router multi-model.

Integrasi SDK Python

Integrasikan dengan cepat menggunakan pustaka Python OpenAI resmi dengan mengarahkannya ke base URL kami. Ini memungkinkan Anda menggunakan metode yang sudah dikenal seperti chat.completions.create() tanpa menulis ulang seluruh logika Anda. Perpustakaan menangani serialisasi secara otomatis, sehingga Anda dapat fokus pada desain prompt daripada detail HTTP.

Konfigurasikan klien dengan URL dasar dan kunci Anda:

Copyfrom openai import OpenAI

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

Ingat bahwa jendela konteks kami adalah 100,000 token, sehingga Anda dapat meneruskan riwayat percakapan yang substansial. SDK akan menangani tokenisasi dan transmisi secara efisien, memastikan prompt Anda mencapai model tanpa overhead atau kesalahan format yang tidak perlu.

Penggunaan SDK Node

Pengembang Node dapat mencapai hasil yang sama menggunakan openai paket npm. Seperti versi Python, Anda harus menimpa URL dasar default untuk menunjuk ke server khusus kami. Ini memastikan permintaan Anda dikirim langsung ke model tanpa sensor tanpa memukul batas laju pihak ketiga atau penundaan pengalihan.

Inisialisasi klien dengan endpoint yang benar:

Copyimport OpenAI from "openai";

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

Pola ini berfungsi untuk panggilan sinkron maupun pola async/await. Anda dapat mengalirkan respons atau meminta mode JSON langsung dalam panggilan fungsi yang sama, memberikan fleksibilitas untuk berbagai arsitektur aplikasi tanpa mengubah pengaturan autentikasi inti Anda.

Respons Streaming

Aktifkan generasi teks real-time dengan mengatur stream: true dalam parameter permintaan Anda. API mengembalikan aliran Server-Sent Events (SSE), memungkinkan Anda menampilkan token saat token tersebut dihasilkan. Ini mengurangi latensi yang dirasakan bagi pengguna, membuat pengalaman terasa jauh lebih cepat daripada menunggu respons penuh.

Tangani chunk stream untuk mengakumulasi teks akhir:

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)

Setiap chunk mencakup data penggunaan token di bagian terakhir, sehingga Anda dapat melacak biaya secara akurat. Streaming ideal untuk antarmuka obrolan di mana umpan balik segera meningkatkan keterlibatan pengguna. Anda dapat menghentikan stream kapan saja jika pengguna mengirim pesan baru, menghemat kredit pada respons parsial.

Batas, Error & Konteks

Memahami batas teknis untuk menghindari gangguan tak terduga dalam aplikasi Anda. API kami memberlakukan jendela konteks 100.000 token untuk setiap permintaan, menggabungkan prompt dan penyelesaian. Jika Anda melebihi batas output 16.000 token, generasi akan berhenti, jadi atur max_tokens sesuai untuk mengendalikan biaya.

Kode status HTTP umum mencakup 401 untuk kunci tidak valid, 402 untuk kredit tidak cukup, dan 429 untuk batas kecepatan. Anda dibatasi hingga 300 permintaan per menit per kunci. Kendala ini memastikan penggunaan yang adil bagi semua pengguna. Gunakan 429 error untuk menerapkan backoff eksponensial dalam kode klien Anda, memastikan operasi lancar selama periode lalu lintas puncak.