Dokumentasi API Ratu API

URL Dasar dan Autentikasi

Autentikasi menggunakan token Bearer standar yang dikirim dalam Authorization header. Pendekatan ini memastikan kompatibilitas dengan SDK OpenAI yang ada tanpa memerlukan logika kustom. Aplikasi API_KEY dihasilkan secara instan saat pendaftaran melalui Google atau email. Semua permintaan harus mengarah ke URL dasar spesifik yang disediakan untuk layanan tersebut.

• URL Dasar: https://api.apiqueen.cc/v1
• Header: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Mengirim Permintaan ke /v1/chat/completions

Kirim data teks ke endpoint untuk mendapatkan respons model langsung. ID model selalu uncensored, yang menangani topik beragam tanpa penolakan standar. Anda dapat menentukan parameter seperti temperature dan top_p untuk mengontrol kreativitas. Sistem mengharapkan daftar pesan dalam format chat standar.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Parameter Model: Suhu, Top-P, dan Stop

Kendalikan generasi respons menggunakan parameter LLM standar. Tetapkan temperature antara 0 dan 2 untuk keacakan yang bervariasi. Gunakan top_p untuk memfilter kata-kata berprobabilitas rendah. Definisikan stop urutan untuk menghentikan output pada pemicu tertentu. Pengaturan ini memungkinkan penyetelan presisi untuk tugas penulisan kreatif atau pengambilan fakta.

API ini mengabaikan parameter yang tidak didukung secara elegan. Fokus pada temperature, top_p, dan stop untuk hasil optimal. Sesuaikan nilai-nilai ini berdasarkan toleransi noise aplikasi Anda.

Respons Streaming dan Penggunaan Token

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan potongan data melalui Server-Sent Events (SSE). Detail penggunaan token hanya muncul di potongan terakhir aliran. Ini memungkinkan rendering waktu nyata respons di UI Anda.

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)

Tangani respons parsial dengan hati-hati. Pastikan klien Anda menampung data hingga aliran ditutup.

Pemanggilan Fungsi dan Mode JSON

Gunakan pemanggilan fungsi untuk ekstraksi data terstruktur. Tentukan alat dalam tools parameter. Model mengembalikan JSON yang valid ketika response_format diatur menjadi {"type": "json_object"}. Ini memastikan parsing yang konsisten dalam aplikasi downstream.

Atur tool_choice untuk memaksa panggilan fungsi tertentu. Ini berguna untuk alur kerja otomatis yang memerlukan format output yang ketat.

Penanganan Kesalahan dan Batasan Laju

Monitor kode status HTTP untuk masalah umum. Kesalahan 401 berarti kunci API Anda tidak valid. Kesalahan 402 menunjukkan kredit prabayar tidak cukup. Kesalahan tidak mengonsumsi saldo token Anda. Batas laju menerapkan 300 permintaan per menit per kunci. Permintaan simultan dibatasi hingga 8. Jendela konteks mendukung 100.000 token total.

Tangani percobaan ulang dengan backoff eksponensial. Periksa error object dalam respons JSON untuk detail.