Panduan Cepat API Embeddings

Autentikasi

Akses API menggunakan kunci API unik yang dihasilkan dari dasbor akun Anda. Sertakan kunci ini dalam header Authorization setiap permintaan menggunakan skema Bearer. URL dasar untuk semua endpoint adalah https://api.embeddingapis.com/v1. URL ini kompatibel dengan SDK OpenAI resmi dan klien apa pun yang dikonfigurasi untuk layanan kompatibel OpenAI. Pastikan kunci Anda disimpan dengan aman karena memberikan akses ke saldo prabayar Anda.

Setiap akun dibatasi hanya untuk satu kunci aktif, yang dapat dibuat ulang kapan saja. Membuat ulang kunci segera mencabut kunci sebelumnya, jadi perbarui konfigurasi Anda segera.

Endpoint Chat Completions

Kirimkan prompt teks ke endpoint POST /v1/chat/completions. API melayani satu model tanpa sensor yang diidentifikasi dengan ID uncensored. Model ini adalah LLM bobot terbuka yang disesuaikan untuk menjawab tanpa penolakan konten untuk topik dewasa yang sah, fiksi, atau riset keamanan. Model ini memproses teks dan menghasilkan teks, menjadikannya ideal untuk langkah pasca-pemrosesan, ringkasan, atau ekstraksi dalam pipeline Anda.

Strukturkan permintaan Anda dengan array messages yang berisi prompt sistem dan pengguna Anda. API mengembalikan respons JSON berisi teks yang dihasilkan.

Copycurl https://api.embeddingapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integrasi SDK Python

Gunakan pustaka Python OpenAI resmi untuk berinteraksi dengan API. Atur base_url ke endpoint kami dan berikan kunci API Anda. Pendekatan ini memungkinkan Anda memanfaatkan kode klien yang ada dengan perubahan minimal. Klien menangani serialisasi dan permintaan jaringan, mengembalikan respons terstruktur yang dapat Anda uraikan untuk logika aplikasi Anda.

Pastikan Anda menggunakan versi SDK terbaru untuk mendukung semua fitur, termasuk streaming dan pemanggilan alat. ID model tetap uncensored saat memanggil penyelesaian.

Copyfrom openai import OpenAI

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

Integrasi SDK Node.js

Untuk lingkungan JavaScript atau TypeScript, gunakan SDK Node.js OpenAI. Konfigurasikan klien dengan URL dasar dan kunci API yang benar. Pengaturan ini memastikan kompatibilitas dengan pipeline berbasis Node Anda. SDK mengelola koneksi ke endpoint POST /v1/chat/completions, memungkinkan Anda mengirim prompt dan menerima penyelesaian teks secara efisien.

Integrasi ini cocok untuk pemrosesan teks sisi server, seperti menghasilkan caption, naskah, atau mengekstrak data dari blok teks besar.

Copyimport OpenAI from "openai";

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

Untuk aplikasi dengan latensi rendah, aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan aliran Server-Sent Events (SSE), mengirimkan token saat dihasilkan. Ini sangat berguna untuk antarmuka pengguna waktu nyata atau saat memproses teks panjang di mana umpan balik langsung sangat berharga.

Uraikan aliran SSE untuk menangani respons parsial. Model tanpa sensor mendukung mode ini, memungkinkan Anda bereaksi terhadap konten saat dihasilkan tanpa menunggu penyelesaian lengkap.

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)

Batas, Kesalahan, dan Jendela Konteks

Jendela konteks mendukung 100.000 token untuk prompt dan penyelesaian secara gabungan. Permintaan yang melebihi batas tubuh 8 MB atau batas laju 300 permintaan per menit akan gagal. Kesalahan autentikasi mengembalikan status 401 jika kunci tidak valid. Ketika saldo prabayar habis, permintaan gagal karena tidak ada kredit yang tersisa untuk menutupi penggunaan token. Status 429 menunjukkan kelelahan batas laju.

Batas konten keras selalu berlaku: permintaan yang berisi konten seksual yang melibatkan anak di bawah umur diblokir, terlepas dari pengaturan lain. Semua konten dewasa yang sah lainnya diproses tanpa penolakan.