Panduan Pengintegrasian

Pengenalan: Permintaan pertama anda

API ini adalah API serasi openai yang meniru struktur Chat Completions. Anda menghantar teks, menerima teks. Tiada endpoint tambahan untuk pengekodan semula (embeddings) atau audio yang mengganggu aliran kerja anda. Mulakan dengan mengarahkan klien anda ke URL asas kami.

• URL Asas: HTTPS://api.filtrosemia.com/v1
• ID Model: "uncensored"

Gantikan URL asas sedia ada anda dalam konfigurasi SDK anda. Penamat ini mengendalikan segalanya dari roleplay hingga terjemahan tanpa penapis biasa.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Pengesahan dan Header

Masukkan kunci API anda dalam header Authorization piawai. Kami menggunakan satu kunci aktif per akaun untuk kemudahan. Jika anda memerlukan yang baharu, jana ia dari papan pemuka anda.

• Header: Authorization: Bearer YOUR_API_KEY
• Tiada aliran OAuth atau token segar untuk diuruskan.

Kekalkan kunci anda selamat. Ia memberikan akses langsung kepada kredit pra-dibayar anda. Ralat seperti 401 Unauthorized bermaksud kunci tiada atau tidak sah.

Copyfrom openai import OpenAI

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

Hujung Sambungan Penyelesaian Sembang

Hantar mesej ke POST /v1/chat/completions. Model ini menyokong parameter piawai seperti temperature, top_p, dan stop urutan. Ia adalah model tanpa sensor yang ditala untuk kandungan dewasa dan kreatif.

• Menyokong json_object format respons.
• Menerima definisi alat untuk pemanggilan fungsi.

Permintaan diproses secara berurutan dalam had kadar anda. Pastikan beban kerja anda kekal di bawah 8 MB.

Copyimport OpenAI from "openai";

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

Gunakan Acara Dihantar Pelayan untuk penghantaran token masa nyata. Ini mengurangkan latensi yang dirasakan untuk output panjang. Pecahan akhir mengandungi statistik penggunaan token lengkap.

• Tetapkan stream: true dalam permintaan anda.
• Uraikan aliran SSE dalam klien anda.

Penstriman berfungsi sama seperti tingkah laku SDK OpenAI standard. Anda mengendalikan pecahan apabila ia tiba.

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)

Tetingkap Konteks dan Had

Model ini menyokong tetingkap konteks 100,000 token. Ini membolehkan beban kerja berat dengan sejarah panjang. Output maksimum ialah 16,000 token setiap permintaan.

• Output maksimum lalai: 2,048 token.
• Had kadar: 300 permintaan setiap minit.

Melampaui had mencetuskan 429 Too Many Requests kesilapan. Laraskan kekoncurren anda untuk kekal dalam had. 8 permintaan serentak dibenarkan setiap kunci.

Penanganan Ralat dan Token

Tangani ralat HTTP standard. 402 Payment Required bermaksud kredit pra-dibayar anda telah habis. 429 menunjukkan had kadar. 401 isyarat masalah pengesahan.

• Kesalahan adalah percuma. Anda hanya membayar untuk penggunaan token yang berjaya.
• Penolakan akibat dasar kandungan juga percuma.

Periksa badan respons untuk mesej ralat terperinci. Gunakan ini untuk menyesuaikan logik cuba semula atau kekerapan tambahan kredit.