Panduan Awal API Dolphin

URL Dasar dan Autentikasi

Kunci API Anda mengautentikasi setiap permintaan ke endpoint kami. Gunakan base URL HTTPS://api.apidolphin.com/v1 dengan SDK OpenAI-compatible apa pun. Identifier model adalah "uncensored" untuk semua completions. Pengaturan ini memastikan kode Anda berfungsi dengan infrastruktur kami tanpa modifikasi.

Kami mendukung parameter standar seperti temperature dan top_p. Anda dapat mengaktifkan mode JSON atau pemanggilan fungsi sesuai kebutuhan. Kesalahan dan penolakan tidak mengonsumsi kredit prabayar Anda. Hanya penggunaan token aktual yang dikenakan biaya dengan tarif transparan kami.

Kirim Permintaan Pertama Anda

Kirim penyelesaian obrolan dasar untuk memverifikasi koneksi Anda. Gunakan perintah curl di bawah ini untuk menguji endpoint. Ganti YOUR_API_KEY dengan kunci aktual Anda dari dasbor. Respons mengembalikan output teks model.

Permintaan ini menggunakan format OpenAI standar. Anda dapat menyesuaikan prompt sistem atau pesan pengguna sesuai kebutuhan. API mengembalikan objek respons yang berisi teks yang dihasilkan. Verifikasi output sesuai dengan harapan Anda sebelum melakukan skalasi.

Contoh penggunaan:

Copycurl https://api.apidolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert the attached JSON payload to YAML format"}]
  }'

Integrasi SDK Python

Gunakan pustaka Python resmi OpenAI untuk berinteraksi dengan API kami. Atur URL dasar dan kunci API dalam konfigurasi klien Anda. Cuplikan kode di bawah ini menunjukkan panggilan generasi teks sederhana.

Instal pustaka melalui pip. Kemudian inisialisasi klien dengan kredensial Anda. Panggil chat.completions.create dengan nama model "uncensored". Pendekatan ini menjaga kode Anda tetap portabel di berbagai penyedia LLM.

Contoh kode:

Copyfrom openai import OpenAI

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

Integrasi SDK Node

SDK Node mengikuti pola konfigurasi yang sama. Inisialisasi klien OpenAI dengan URL dasar dan kunci Anda. Kirim permintaan penyelesaian menggunakan model "uncensored". Metode ini ideal untuk aplikasi sisi server.

Pastikan Anda menangani data respons dengan benar. API mengembalikan objek penyelesaian standar. Anda dapat mengakses teks yang dihasilkan dari objek respons. Penyiapan ini berfungsi dengan Express, Fastify, atau kerangka kerja Node.js lainnya.

Contoh implementasi:

Copyimport OpenAI from "openai";

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

Tangani Respons Streaming

Aktifkan streaming untuk pengiriman token real-time. Tetapkan parameter stream menjadi true dalam permintaan Anda. API mengembalikan potongan data saat potongan tersebut dihasilkan. Hal ini mengurangi latensi yang dirasakan bagi pengguna akhir.

Proses setiap potongan dalam logika aplikasi Anda. Potongan terakhir berisi detail penggunaan token terakhir. Streaming bekerja dengan semua parameter yang didukung. Ini ideal untuk antarmuka obrolan dan generasi teks langsung.

Contoh 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)

Batas, Error, dan Jendela Konteks

Akun Anda memiliki jendela konteks 100.000 token. Ini mencakup token prompt dan penyelesaian. Output maksimum per permintaan adalah 16.000 token. Jika Anda tidak mengatur max_tokens, batasnya adalah 2.048 token.

Batas laju mengizinkan 300 permintaan per menit per kunci. Anda dapat memiliki 8 permintaan konkurensi. Batas ukuran badan permintaan adalah 8 MB. Tangani HTTP 401 untuk kunci tidak valid, 402 untuk kredit tidak cukup, dan 429 untuk batas laju. Kesalahan gratis, sehingga Anda dapat mencoba lagi tanpa biaya.