Chatmodelle

Die PopNow API bietet auch Chatmodelle: Claude, Gemini, DeepSeek, GLM, Grok und Kimi. Du rufst sie über die Protokolle auf, die dein Code bereits nutzt – OpenAI Chat Completions und Responses, Anthropic Messages und Gemini generateContent. Die offiziellen SDKs funktionieren also, sobald du die Basis-URL änderst. Sie verwenden denselben sk-popnow--Schlüssel und dasselbe separate API-USD-Guthaben wie API-Bilder, -Video und -Audio. Es beginnt bei $0; lade unter API-Abrechnung auf. Website-Credits können diese Aufrufe nicht bezahlen.

Chataufrufe sind synchron: Die Antwort (oder ein Stream) kommt in derselben HTTP-Antwort zurück. Du musst keinen Task abfragen.

Auf einen Blick

Deine erste Chatanfrage

curl https://api.popnow.ai/v1/chat/completions \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-haiku-5.5/chat",
    "messages": [
      { "role": "system", "content": "You are a concise, friendly assistant." },
      { "role": "user", "content": "Suggest three names for a kite shop by the sea." }
    ],
    "max_tokens": 512
  }'

Die Antwort ist ein gewöhnliches chat.completion-Objekt mit choices[0].message.content und usage. Der Antwortheader X-PopNow-Task-Id nennt den Task, der die Abbuchung protokolliert.

OpenAI-SDK

Setze die Client-URL auf https://api.popnow.ai/v1 und übergib deinen PopNow-Schlüssel. Alles andere bleibt gleich.

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.popnow.ai/v1", api_key=os.environ["POPNOW_API_KEY"])

reply = client.chat.completions.create(
    model="anthropic/claude-haiku-5.5/chat",
    messages=[{"role": "user", "content": "Write a haiku about kites."}],
    max_tokens=200,
)
print(reply.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://api.popnow.ai/v1', apiKey: process.env.POPNOW_API_KEY });

const reply = await client.chat.completions.create({
  model: 'google/gemini-3.7-flash/chat',
  messages: [{ role: 'user', content: 'Write a haiku about kites.' }],
  max_tokens: 200,
});
console.log(reply.choices[0].message.content);

Auch die Responses API (client.responses.create) funktioniert, und zwar zustandslos: Sende jedes Mal das gesamte Gespräch in input. previous_response_id liefert 400.

Anthropic-SDK

Das Anthropic-SDK hängt /v1/messages selbst an; die Basis-URL enthält deshalb kein /v1.

import os
import anthropic

client = anthropic.Anthropic(base_url="https://api.popnow.ai", api_key=os.environ["POPNOW_API_KEY"])

message = client.messages.create(
    model="anthropic/claude-sonnet-5.5/chat",
    max_tokens=512,
    messages=[{"role": "user", "content": "Explain idempotency keys in two sentences."}],
)
print(message.content[0].text)

Dieser Endpunkt funktioniert mit jedem Chatmodell, nicht nur mit Claude. Fehler kommen im Anthropic-Format {"type": "error", "error": {...}} zurück.

Gemini generateContent

Setze die vollständige Modell-ID in den Pfad; sie darf Schrägstriche enthalten.

curl "https://api.popnow.ai/v1beta/models/google/gemini-3.7-flash/chat:generateContent" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "role": "user", "parts": [{ "text": "Name three colours of a sunset." }] }],
    "generationConfig": { "maxOutputTokens": 256 }
  }'

Für einen Stream verwende :streamGenerateContent?alt=sse. Fehler nutzen das Google-Format {"error": {"code", "message", "status"}}.

Streaming

Setze stream: true und lies Server-Sent Events. Bei Chat Completions ist jeder Teil ein chat.completion.chunk, und der Stream endet mit data: [DONE]. Wie bei OpenAI enthält ein Stream keine usage, solange du sie nicht mit stream_options: { "include_usage": true } anforderst. Die Nutzungsdaten kommen dann in einem letzten Teil mit leerem choices-Array.

stream = client.chat.completions.create(
    model="anthropic/claude-haiku-5.5/chat",
    messages=[{"role": "user", "content": "Count from one to five."}],
    max_tokens=100,
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Tools, JSON-Ausgabe und Parameter

Jedes Modell gibt an, welche Anfragefelder es unterstützt – tools, tool_choice, response_format, temperature, reasoning_effort und weitere. Die Spalte Parameters in der Modelltabelle führt sie auf; GET /v1/models liefert sie in supported_parameters.

• Eine vom Modell nicht unterstützte Sampling-Einstellung (temperature, top_p, frequency_penalty …) wird verworfen, statt einen Fehler auszulösen, und im Antwortheader X-PopNow-Ignored-Params genannt.
• Ein Wert außerhalb des zulässigen Bereichs wird auf den nächstgelegenen zulässigen Wert gesetzt und in X-PopNow-Adjusted-Params als name=value gemeldet.
• Jedes andere vom Modell nicht deklarierte Feld liefert 400 mit code: unsupported_parameter; param nennt das Feld. Das gilt etwa für einen Bildteil, der an ein reines Textmodell gesendet wird.

Modelle und Preise

Preise gelten in USD pro 1 Million Tokens, getrennt für Eingabe und Ausgabe. Bei Modellen mit Cache ist zwischengespeicherte Eingabe günstiger. Manche Modelle berechnen einen höheren Satz, sobald eine Anfrage eine bestimmte Kontextlänge überschreitet; die Schwelle steht unter dem Modellnamen.

Dieselbe Liste mit Preisen, Kontextlänge und unterstützten Parametern ist über die API verfügbar:

curl "https://api.popnow.ai/v1/models?modality=text" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

So wird eine Chatanfrage abgerechnet

1. Reservieren. Bei Annahme der Anfrage wird der höchstmögliche Preis vom Guthaben zurückgelegt, berechnet aus der Eingabe und max_tokens. Lässt du max_tokens weg, zählt die maximale Ausgabelänge des Modells. Setze den Wert daher, um Reservierungen klein zu halten.
2. Abrechnen. Am Ende der Antwort zahlst du die tatsächlich genutzten Tokens, in USD und ohne Mindestbetrag pro Anfrage. Der Rest der Reservierung wird freigegeben.
3. Erstatten. Schlägt eine Anfrage fehl oder lehnt das Modell sie ab, wird sie vollständig erstattet.

Reicht das Guthaben nicht für die Reservierung oder würde ein Ausgabelimit des Schlüssels überschritten, kommt 402, bevor etwas an das Modell gesendet wird. Den genauen Betrag liest du am Task aus X-PopNow-Task-Id mit GET /api/v1/jobs/recordInfo: costUsd ist der USD-Dezimalstring für Anzeige und Buchhaltung. Alte Credit-Felder können ebenfalls vorkommen; runde USD-Abbuchungen nicht auf ganze Credits.

Lange Antworten und Fehler

• Lange Aufrufe ohne Streaming. Dauert die Antwort länger als etwa 30 Sekunden, werden zuerst der Status 200 und der Header X-PopNow-Keepalive: 1 gesendet, danach alle 15 Sekunden ein Zeilenumbruch und schließlich der JSON-Body. Ein späterer Fehler kommt als übliches Fehlerobjekt des Protokolls im 200-Body an. Prüfe daher auf einen error-Schlüssel, wenn dieser Header vorhanden ist. Streaming vermeidet das.
• 404 model_not_found. Die Modell-ID existiert nicht. Der Fehler nennt das ähnlichste aufrufbare Chatmodell.
• 400 mit param: model. Die ID gehört zu einem Bild-, Video- oder Audiomodell; diese laufen als Tasks.
• 400 content_rejected. Die Inhaltsregeln des Modells haben die Anfrage abgelehnt. Es wird nichts berechnet.
• 402. Nicht genug API-USD für die Reservierung oder ein Ausgabelimit des Schlüssels. Siehe API-Abrechnung.

Datenschutz

Anfragen werden so an das Modell gesendet, wie du sie geschrieben hast; PopNow fügt keinen eigenen Systemprompt hinzu. Es gelten die Nutzungsregeln des jeweiligen Modells. Nachrichtentexte werden nach Abschluss der Abrechnung nicht aufbewahrt.

Verwandte Seiten