Panduan Mulai Cepat API Dolphin OpenRouter

URL Dasar dan Autentikasi

URL dasar untuk semua permintaan adalah https://api.openrouterdolphin.com/v1. Anda mengautentikasi dengan meneruskan kunci API Anda di Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

Autentikasi ketat. Kami tidak mendukung beberapa kunci per akun. Membuat kunci baru segera membuat kunci sebelumnya tidak valid. Ini memastikan pelacakan penggunaan yang bersih untuk kredit prabayar Anda.

Endpoint: POST /v1/chat/completions

Kirim data teks untuk menghasilkan respons menggunakan uncensored model. Endpoint ini menangani semua penyelesaian chat standar. Anda menentukan model, pesan, dan parameter dalam body permintaan.

Copyfrom openai import OpenAI

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

API mengembalikan objek JSON standar yang berisi teks yang dihasilkan. API ini tidak mendukung embedding, gambar, atau audio. Fokuskan pada alur kerja generasi teks. Model merespons prompt tanpa menyaring topik dewasa yang sah atau kontroversial.

Endpoint: GET /v1/models

Ambil model yang tersedia melalui permintaan GET sederhana. Endpoint ini mengonfirmasi ID model yang harus Anda gunakan.

Copyimport OpenAI from "openai";

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

Respons mencantumkan uncensored model. Gunakan ID tepat ini dalam permintaan penyelesaian Anda. API hanya melayani model tunggal ini. Tidak ada logika routing atau pemilihan model. Anda berinteraksi langsung dengan instance LLM uncensored khusus kami.

Data Streaming dan Penggunaan

Aktifkan streaming dengan mengatur stream: true. API mengembalikan chunk melalui Server-Sent Events (SSE). Setiap chunk berisi sebagian dari teks respons.

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)

Bagian terakhir mencakup statistik penggunaan token lengkap. Anda hanya membayar untuk token output yang dihasilkan. Kesalahan dan penolakan tidak dikenakan biaya. Struktur ini memungkinkan rendering respons secara real-time di aplikasi Anda.

Parameter: Suhu, Top P, dan Tools

Kendalikan perilaku generasi dengan parameter standar. Tetapkan temperature untuk keacakan dan top_p untuk sampling nuklir. Aktifkan panggilan fungsi dengan menyediakan tools array.

Gunakan response_format dengan {"type": "json_object"} untuk output JSON ketat. Anda juga dapat menetapkan seed untuk reproduktibilitas. API mendukung presence_penalty dan frequency_penalty untuk menyesuaikan penggunaan kata. Parameter-parameter ini bekerja persis seperti di klien OpenAI standar.

Batas Laju dan Ukuran Permintaan

Setiap kunci API mengizinkan 300 permintaan per menit. Anda dapat memiliki hingga 8 permintaan simultan pada satu waktu. Ukuran badan permintaan maksimum adalah 8 MB. Jendela konteks mendukung 100.000 token untuk input dan output secara gabungan.

Output maksimal per permintaan adalah 16,000 token. Jika Anda tidak mengatur max_tokens, nilai defaultnya adalah 2.048 token. Melampaui batas ini akan mengembalikan error 429. Rencanakan strategi batching Anda dengan tepat. Kredit tidak pernah kedaluwarsa, sehingga Anda dapat mengumpulkan penggunaan seiring waktu tanpa tekanan.