Dokumentasi API & Permulaan Pantas

Pengesahan & URL Asas

Mula dengan menjana kunci API anda di papan pemuka. Kami menggunakan header serasi OpenAI standard, jadi anda hanya perlu mengemas kini base_url dan API_KEY pemboleh ubah. Ini memastikan integrasi SDK sedia ada anda berfungsi tanpa pengubahsuaian. Kami menyokong Google Sign-In atau pendaftaran e-mel/kata laluan, dan kunci anda muncul serta-merta selepas dibuat.

• URL Asas: https://api.routeropen.cc/v1
• Header Auth: Authorization: Bearer YOUR_API_KEY

Kekalkan kunci anda selamat, kerana ia mengawal kredit pra-dibayar anda. Setiap akaun membolehkan satu kunci aktif pada satu masa; menjana kunci baru akan menggantikan yang lama serta-merta.

Permintaan Pertama

Hantar arahan pertama anda menggunakan standard chat/completions endpoint. ID model hanyalah uncensored. Ini menghantar teks masuk dan mengembalikan teks keluar, tanpa penapis kandungan untuk penggunaan dewasa yang sah.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

Permintaan ini menunjukkan struktur asas. Anda boleh menyesuaikan parameter seperti temperature atau top_p untuk mengawal kreativiti. Respons termasuk statistik penggunaan token untuk pengebilan telus.

Integrasi SDK Python

Gunakan perpustakaan Python rasmi OpenAI untuk mengintegrasikan API kami. Arahkan klien ke URL asas kami dan gunakan kunci API anda. Pendekatan ini berfungsi dengan lancar dengan pangkalan kod sedia ada yang sudah menyasarkan OpenAI.

Copyfrom openai import OpenAI

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

Pustaka mengendalikan serialisasi JSON dan aliran secara automatik. Anda boleh mengkonfigurasi logik percubaan semula dan had masa mengikut keperluan. Hujung titik kami menyokong parameter piawai, menjadikan migrasi dari penyedia lain mudah.

Integrasi SDK Node

Untuk pembangun JavaScript, SDK Node berfungsi dengan perubahan minimum. Tetapkan baseURL ke endpoint kami dan berikan kunci anda. Ini membolehkan anda mengekalkan aliran kerja pembangunan semasa anda sambil mengakses model uncensored.

Copyimport OpenAI from "openai";

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

Pengguna Node boleh memanfaatkan corak async/await untuk kod yang bersih. Struktur respons sepadan dengan piawaian OpenAI, memastikan keserasian dengan pengurai sedia ada. Anda boleh menukar model atau penyedia dengan menukar hanya dua pembolehubah.

Respons Streaming

Aktifkan aliran dengan menetapkan stream: true dalam permintaan anda. Kami memulangkan Acara yang Dihantar Pelayan (SSE) untuk penghantaran token masa nyata. Ini mengurangkan latensi yang dirasakan oleh pengguna 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)

Potongan akhir mengandungi jumlah penggunaan token untuk pembil. Penstriman berfungsi dengan semua parameter, termasuk pemanggilan fungsi. Gunakan ini untuk antara muka sembang di mana maklum balas serta-merta adalah kritikal. Ralat masih dipulangkan sebagai peristiwa SSE, jadi anda boleh menangani kegagalan dengan anggun.

Had, Ralat & Konteks

API kami mengenakan tetingkap konteks 100,000-token dan had badan permintaan 8MB. Anda boleh membuat 300 permintaan setiap minit per kunci. Jika anda melebihi ini, anda akan menerima ralat had kadar 429. Kegagalan pengesahan mengembalikan 401, dan kredit tidak mencukupi mengembalikan 402.

Kesilapan tidak menggunakan kredit pra-dibayar anda. Jika anda menghantar permintaan yang tidak sah, anda tidak dikenakan caj. Model menolak permintaan yang melibatkan kanak-kanak, tetapi sebaliknya membenarkan kandungan tanpa sekatan. Kekalkan pengendalian ralat yang kukuh untuk mengurus had kadar dengan berkesan.