Quickstart: Unzensierte Text-API für Bild-Pipelines

Basis-URL & Authentifizierung

Unsere API folgt der Standard-Struktur von OpenAI chat-completions. Navigiere zur Seite API-Schlüssel erstellen und registriere dich mit E-Mail und Passwort. Der API-Schlüssel wird sofort angezeigt. Für das Testguthaben werden keine Telefonnummer oder Kreditkarte benötigt, für dauerhafte Nutzung ist jedoch Prepaid-Guthaben erforderlich.

Setze deine Base URL auf https://api.imagegenapi.com/v1. Füge deinen API-Schlüssel als Bearer-Token in den Authorization-Header ein. Diese Konfiguration funktioniert mit jeder OpenAI-kompatiblen Client-Bibliothek. Die zu verwendende Modellkennung ist uncensored, ein Open-Weight-Modell, das darauf abgestimmt ist, ohne Ablehnungen zu antworten für die rechtmäßige Nutzung durch Erwachsene.

Prompt senden

Sende eine Standard-chat.completions-Anfrage zur Textgenerierung. Die API akzeptiert eine Liste von Nachrichten im messages-Array. Sie gibt ein JSON-Objekt zurück, das die Generierung enthält. Dies ist ideal für einmalige Prompt-Generierung oder Metadaten-Bearbeitung, wenn kein Streaming erforderlich ist.

Copycurl https://api.imagegenapi.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."}]
  }'

Der Anfragekörper enthält das Feld model mit dem Wert uncensored und deinen Konversationsverlauf. Die Antwort enthält die Antwort des Assistenten, die du dann in deine Bildgenerierungspipeline einspeisen oder als Bildunterschrift verwenden kannst.

Python SDK-Integration

Für Python-Entwickler: Nutze die offizielle openai-Bibliothek. Konfiguriere base_url und api_key, um auf unseren Dienst zu verweisen. So kannst du vertraute Python-Idiome nutzen und gleichzeitig auf unser unzensiertes Modell zugreifen.

Copyfrom openai import OpenAI

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

Initialisiere den Client mit deinem Schlüssel und der korrekten Basis-URL. Rufe chat.completions.create() mit deinen Nachrichten auf. Dieser Ansatz eignet sich am besten für Batch-Verarbeitungen oder wenn du die JSON-Antwort direkt in deiner Anwendungslogik parsen musst. Denke daran, dass die Modell-ID uncensored sein muss.

Node.js SDK-Nutzung

Node.js-Entwickler können das openai-npm-Paket nutzen. Setze baseURL auf unseren Endpunkt. Dies ist nützlich für Server-Side-Rendering oder API-Gateways, in denen du Textantworten asynchron verarbeiten musst.

Copyimport OpenAI from "openai";

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

Erstelle die Client-Instanz mit deinem API-Schlüssel und der Base URL. Rufe chat.completions.create() auf, um die Textausgabe zu erhalten. Diese Methode eignet sich zur Generierung von Skripten, Bildunterschriften oder zum Extrahieren von Informationen aus Text, bevor er in deiner Bildpipeline verwendet wird.

Streaming-Antworten

Aktiviere für die Echtzeit-Textgenerierung das Streaming, indem du stream: true setzt. Die API gibt einen Server-Sent Events (SSE)-Stream zurück, kein einzelnes JSON-Objekt. Du musst die delta-Chunks verarbeiten, sobald sie eintreffen, um die vollständige Nachricht zu rekonstruieren.

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)

Iteriere über den Stream, um Text inkrementell anzuzeigen. Dies ist kritisch für Anwendungen, bei denen Latenz eine Rolle spielt, wie z. B. Live-Prompt-Bearbeitung oder interaktive Chat-Oberflächen. Jeder Chunk enthält einen Teil der Antwort, sodass du Text rendern kannst, während er generiert wird.

Ratenlimits & Einschränkungen

Jeder API-Schlüssel ist auf 300 Anfragen pro Minute begrenzt. Der Anfragekörper darf 8 MB nicht überschreiten. Wenn du das Limit überschreitest, erhältst du einen 429-Fehler. Generiere deinen Schlüssel bei Bedarf neu, wodurch der alte ungültig wird.

Wenn dein Prepaid-Guthaben aufgebraucht ist, lehnt die API Anfragen ab. Es gibt keine unbegrenzte kostenlose Stufe; du musst Guthaben aufladen. Der Fehler 401 bedeutet einen ungültigen oder fehlenden API-Schlüssel. Stelle sicher, dass dein Schlüssel korrekt im Authorization-Header gesetzt ist. Das Kontextfenster umfasst 100.000 Token für Prompt und Antwort.