Panduan Cepat API Dolphin models ai
Dolphin models AI menyediakan API kompatibel OpenAI yang sederhana untuk inferensi tanpa sensor. Panduan cepat ini memandu Anda melalui autentikasi, pengiriman permintaan, dan penanganan data streaming dengan penagihan per token yang dapat diprediksi.
1. Prasyarat: SDK dan Kunci API
Daftar menggunakan akun Google atau email untuk menerima kunci API secara instan. Anda memerlukan SDK resmi untuk bahasa pilihan Anda agar dapat berkomunikasi dengan endpoint. Kunci ini mengautentikasi setiap permintaan yang Anda kirim.
2. Konfigurasi URL Dasar Anda
Atur URL dasar ke HTTPS://api.dolphinmodelsai.com/v1 dalam konfigurasi klien Anda. URL ini mengarahkan permintaan Anda ke server inferensi uncensored kami. Pastikan kunci API Anda diteruskan di header otorisasi. Titik akhir mengikuti pola standar OpenAI untuk kompatibilitas.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.dolphinmodelsai.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);
3. Kirim Permintaan Penyelesaian Chat Pertama Anda
Kirim permintaan POST ke /v1/chat/completions dengan model id "uncensored". Sertakan riwayat pesan Anda dalam array messages. API mengembalikan respons teks tanpa penolakan konten untuk penggunaan dewasa yang sah. Anda dapat menyesuaikan parameter seperti temperature untuk mengontrol tingkat keacakan.
curl https://api.dolphinmodelsai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the time complexity of this sorting algorithm"}]
}'
4. Aktifkan Streaming dan Tangani Penggunaan Token
Atur streaming ke true untuk menerima token saat dihasilkan. Setiap chunk berisi teks parsial dan metadata penggunaan. Chunk terakhir mencakup total hitungan token untuk akurasi penagihan. Pendekatan ini mengurangi latensi yang dirasakan untuk respons panjang.
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)
5. Gunakan Mode JSON untuk Output Terstruktur
Kirimkan response_format sebagai {"type": "json_object"} untuk memaksakan output terstruktur. Model menjamin sintaks JSON yang valid dalam respons. Fitur ini sangat ideal untuk mengurai data ke dalam logika aplikasi Anda. Ini menghilangkan kebutuhan akan validasi regex manual.
6. Implementasikan Function Calling (Alat)
Tentukan alat dalam permintaan Anda untuk mengaktifkan kemampuan pemanggilan fungsi. Model dapat mengembalikan panggilan alat alih-alih teks biasa. Anda mengeksekusi fungsi dan mengirimkan hasilnya kembali ke model. Pola ini mendukung alur kerja multi-langkah yang kompleks.
7. Pahami Batas Kecepatan dan Parameter
Setiap kunci API dibatasi hingga 300 permintaan per menit. Anda dapat memiliki 8 permintaan simultan kapan saja. Jendela konteks mendukung hingga 100.000 token untuk input dan output secara gabungan. Permintaan yang melebihi batas ini menerima kode kesalahan 429. Kesalahan kredit mengembalikan status 402.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.dolphinmodelsai.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)Pertanyaan umum
Bagaimana cara mengautentikasi permintaan saya?
Sertakan kunci API Anda di header Authorization sebagai token Bearer. Kunci dibuat segera setelah pendaftaran. Kunci tetap berlaku hingga Anda mencabut atau menggantinya.
Apa yang terjadi jika saya melebihi batas laju?
API mengembalikan error 429 Too Many Requests. Anda harus menunggu hingga jendela batas laju direset. Batas permintaan konkuren juga berlaku untuk mencegah kelelahan sumber daya.
Apakah model uncensored gratis?
Tidak, ini menggunakan kredit prabayar yang dibebankan per token. Anda menerima kredit percobaan untuk akun baru. Penagihan transparan tanpa biaya bulanan tersembunyi.
Dapatkan kunci Anda sekarang
Daftar, salin kunci, perbarui endpoint Anda. Selesai.
Coba dengan kredit percobaan