Opensfw API Quickstart Guide

Authentication and Base URL

Ξεκινήστε δημιουργώντας το κλειδί σας στον πίνακα ελέγχου. Χρησιμοποιήστε το https://api.opensfw.com/v1 base URL και ορίστε το κλειδί API σας στο Authorization header. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε τυπικό client OpenAI SDK.

Κάντε την πρώτη αίτηση ολοκλήρωσης συνομιλίας

Στείλτε ένα POST request στο /v1/chat/completions με το μοντέλο ID σας και τα μηνύματα. Το uncensored μοντέλο επεξεργάζεται την είσοδό σας και επιστρέφει το παραγόμενο κείμενο. Χρησιμοποιήστε το παράδειγμα curl παρακάτω για να επαληθεύσετε τη σύνδεση.

Copycurl https://api.opensfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current release version of the model?"}]
  }'

Οι ροές απαντήσεων (streaming) και η χρήση token

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Λαμβάνετε κομμάτια κειμένου καθώς παράγονται. Το τελευταίο κομμάτι περιέχει τα πλήρη στατιστικά χρήσης tokens για την χρέωση. Χρησιμοποιήστε το παράδειγμα Python για να διαχειριστείτε τη ροή.

Copyfrom openai import OpenAI

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

Κλήση συναρτήσεων και λειτουργία JSON

Ορίστε εργαλεία στο αίτημά σας για δομημένες εξόδους. Χρησιμοποιήστε response_format: {"type": "json_object"} για αυστηρές αποκρίσεις JSON. Αυτό λειτουργεί ομαλά με τις τυπικές παραμέτρους κλήσης συναρτήσεων.

Copyimport OpenAI from "openai";

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

Διαχείριση σφαλμάτων και ορίων ρυθμού

Ελέγξτε για 401 if your key is invalid, 402 για ανεπαρκή πιστωτικό υπόλοιπο, και 429 για όρια ρυθμού. Λαμβάνετε 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Τα σφάλματα δεν καταναλώνουν tokens.

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)

Κατανόηση παραθύρων συγκειμένου και ορίων

Το μοντέλο χωρίς λογοκρισία υποστηρίζει παράθυρο πλαισίου 100.000 tokens. Prompt και completion συνολικά. Μέγιστη έξοδος 16.000 tokens ανά αίτημα. Κρατήστε το σώμα του αιτήματος κάτω από 8 MB. Αυτό εξασφαλίζει σταθερή απόδοση για μεγάλα εισερχόμενα δεδομένα.