Panduan Pengintegrasian untuk Pembangun

Pengesahan dan penetapan URL asas

Mula dengan menjana kunci API anda di papan pemuka. URL asas ialah HTTPS://api.apiaicheap.com/v1. Hantar kunci anda dalam header Authorization sebagai token bearer.

• Klik "Dapatkan API key" dan log masuk dengan Google atau e-mel.
• Salin kunci serta-merta; ia hanya ditunjukkan sekali.

Kunci ini mengesahkan semua permintaan ke akhiran penyelesaian sembang.

Contoh Header

Pengesahan: Bearer YOUR_API_KEY

Permintaan pertama dengan cURL

Hantar penyelesaian sembang asas untuk menguji persediaan anda. Gunakan hujung akhir POST /v1/chat/completions dengan model "uncensored".

Ini mengesahkan baki kredit dan latensi anda.

• Tetapkan role kepada "user".
• Kekalkan mesej mudah untuk ujian pertama.

Periksa respons untuk medan teks yang dijana.

• Cari nilai "content".

Jika anda mendapat 200 OK, integrasi anda berfungsi.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Python SDK integration

Gunakan perpustakaan Python rasmi OpenAI untuk integrasi yang mudah. Arahkan ia ke URL asas kami dan tetapkan kunci API anda.

Pendekatan ini mengendalikan cubaan semula dan penguraian JSON secara automatik.

• Pasang perpustakaan melalui pip.
• Tetapkan parameter base_url ke hujung kami.

Panggil kaedah chat.completions.create.

Masukkan senarai mesej anda sebagai hujah.

• Termasuk nama model "uncensored".

Akses teks respons melalui atribut objek.

Kaedah ini bersih dan mudah dibaca untuk skrip pengeluaran.

Copyfrom openai import OpenAI

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

Persediaan SDK Node.js

SDK Node.js berfungsi serupa dengan versi Python. Mulakan klien dengan kunci anda dan URL asas kami.

Ini membolehkan anda menggunakan corak async/await yang biasa.

• Import pakej OpenAI.
• Konfigurkan URL asas dalam konstruktor.

Buat permintaan penyelesaian dengan mesej anda.

Tangani janji untuk mendapatkan keputusan.

• Ekstrak kandungan mesej daripada respons.

Log output untuk mengesahkan model memberi respons dengan betul.

Konfigurasi ini sesuai untuk pelayan web dan perkhidmatan backend.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheap.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 penstriman dengan SSE

Aktifkan penstriman dengan menetapkan stream kepada true dalam permintaan anda. API mengembalikan bahagian apabila ia dijana melalui Acara yang Dihantar Pelayan.

Ini mengurangkan latensi yang dirasakan untuk pengguna dalam aplikasi sembang.

• Tetapkan stream: true dalam payload.
• Proses setiap potongan sebagaimana ia tiba.

Gabungkan chunk untuk membentuk respons akhir.

Butiran penggunaan token muncul dalam potongan terakhir.

• Semak medan "usage" dalam potongan akhir.

Pendekatan ini mengekalkan antara muka pengguna responsif semasa penjanaan jangka panjang.

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)

Had, ralat, dan tetingkap konteks

Akaun anda mempunyai had 300 permintaan setiap minit per kunci. Tetingkap konteks menyokong 100,000 token jumlah untuk prompt dan penyelesaian.

Ralat ditangani dengan kod status HTTP piawai.

• 401 menunjukkan kunci API yang tidak sah atau hilang.
• 402 bermaksud baki pra-dibayar anda telah habis.
• 429 menandakan anda telah melebihi had laju.

Penolakan tidak menelan kredit. Ralat juga percuma.

Output maks ialah 16,000 token setiap permintaan. Tetapkan max_tokens jika anda memerlukan kurang.

Struktur ini memastikan pengebilan dan prestasi yang boleh ramal.