Modele czatu

API PopNow obsługuje też modele czatu: Claude, Gemini, DeepSeek, GLM, Grok i Kimi. Wywołujesz je przez protokoły, z których twój kod już korzysta — OpenAI Chat Completions i Responses, Anthropic Messages oraz Gemini generateContent — więc oficjalne SDK działają po zmianie bazowego adresu URL. Korzystają z tego samego klucza sk-popnow- i tego samego osobnego salda API w USD co obrazy, wideo i audio przez API. Początkowo wynosi ono 0 USD; doładuj je w rozliczeniach API. Kredyty strony nie opłacają tych wywołań.

Wywołania czatu są synchroniczne: odpowiedź (lub strumień) wraca w tym samym wywołaniu. Nie ma zadania do odpytywania.

Najważniejsze informacje

Twoje pierwsze zapytanie do czatu

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
  }'

Odpowiedź to standardowy obiekt chat.completion z polami choices[0].message.content i usage. Nagłówek odpowiedzi X-PopNow-Task-Id wskazuje zadanie, w którym zapisano obciążenie.

SDK OpenAI

Ustaw adres klienta na https://api.popnow.ai/v1 i przekaż klucz PopNow. Niczego więcej nie trzeba zmieniać.

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);

Działa też Responses API (client.responses.create), w wariancie bez przechowywania stanu: za każdym razem wyślij całą rozmowę w input. previous_response_id zwraca 400.

SDK Anthropic

SDK Anthropic samo dodaje /v1/messages, więc bazowy URL nie zawiera /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)

Ten endpoint obsługuje każdy model czatu, nie tylko Claude. Błędy wracają w formacie Anthropic {"type": "error", "error": {...}}.

Gemini generateContent

Umieść pełne ID modelu w ścieżce; może zawierać ukośniki.

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 }
  }'

Aby otrzymać strumień, użyj :streamGenerateContent?alt=sse. Błędy mają format Google {"error": {"code", "message", "status"}}.

Strumieniowanie

Ustaw stream: true i odczytuj Server-Sent Events. W Chat Completions każdy fragment to chat.completion.chunk, a strumień kończy się komunikatem data: [DONE]. Tak jak w OpenAI strumień nie zawiera usage, chyba że poprosisz o nie przez stream_options: { "include_usage": true }; dane o zużyciu pojawią się wtedy w ostatnim fragmencie z pustą tablicą choices.

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="")

Narzędzia, wynik JSON i parametry

Każdy model deklaruje obsługiwane pola zapytania — tools, tool_choice, response_format, temperature, reasoning_effort i inne. Wymienia je kolumna Parameters w tabeli modeli, a GET /v1/models zwraca je w supported_parameters.

• Ustawienie próbkowania nieobsługiwane przez model (temperature, top_p, frequency_penalty …) jest pomijane zamiast powodować błąd; jego nazwa trafia do nagłówka odpowiedzi X-PopNow-Ignored-Params.
• Wartość spoza zakresu modelu jest zmieniana na najbliższą dozwoloną wartość i zgłaszana w X-PopNow-Adjusted-Params jako name=value.
• Każde inne pole, którego model nie deklaruje, zwraca 400 z code: unsupported_parameter i param wskazującym pole, np. część z obrazem wysłana do modelu obsługującego tylko tekst.

Modele i ceny

Korzystaj z cen w USD za 1 milion tokenów, osobno dla wejścia i wyjścia; wejście z pamięci podręcznej jest tańsze w modelach, które ją obsługują. Niektóre modele stosują wyższą stawkę po przekroczeniu progu długości kontekstu — jest on podany pod nazwą modelu.

Ta sama lista jest dostępna przez API, wraz z cenami, długością kontekstu i obsługiwanymi parametrami:

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

Jak rozliczane jest zapytanie do czatu

1. Blokada. Gdy zapytanie zostanie przyjęte, z salda odkładany jest jego maksymalny możliwy koszt, wyliczony z danych wejściowych i max_tokens. Jeśli pominiesz max_tokens, używana jest maksymalna długość odpowiedzi modelu, więc ustaw ten parametr, by ograniczyć blokadę.
2. Obciążenie. Po zakończeniu odpowiedzi płacisz za faktycznie zużyte tokeny, w USD, bez minimalnej opłaty za zapytanie. Reszta blokady jest zwalniana.
3. Zwrot. Zapytanie, które się nie powiedzie lub które model odrzuci, jest w całości zwracane.

Saldo niższe od wymaganej blokady lub przekroczenie limitu wydatków klucza zwraca 402, zanim cokolwiek zostanie wysłane do modelu. Aby sprawdzić dokładne obciążenie, odczytaj zadanie wskazane w X-PopNow-Task-Id przez GET /api/v1/jobs/recordInfo: costUsd to ciąg dziesiętny w USD do wyświetlania i księgowości. Starsze pola kredytów mogą nadal występować; nie zaokrąglaj obciążeń w USD do pełnych kredytów.

Długie odpowiedzi i błędy

• Długie wywołania bez strumieniowania. Jeśli odpowiedź trwa dłużej niż około 30 sekund, najpierw wysyłany jest status 200 z nagłówkiem X-PopNow-Keepalive: 1, następnie co 15 sekund znak nowego wiersza, a na końcu treść JSON. Błąd po tym momencie przychodzi jako zwykły obiekt błędu danego protokołu w treści odpowiedzi 200, więc przy tym nagłówku sprawdzaj obecność klucza error. Strumieniowanie pozwala tego uniknąć.
• 404 model_not_found. ID modelu nie istnieje. Błąd wskazuje najbardziej zbliżony model czatu, który możesz wywołać.
• 400 z param: model. ID należy do modelu obrazu, wideo lub audio; te działają jako zadania.
• 400 content_rejected. Zasady treści danego modelu spowodowały odrzucenie zapytania. Nic nie płacisz.
• 402. Za mało USD w API na blokadę lub osiągnięty limit wydatków klucza. Zobacz Rozliczenia API.

Prywatność

Zapytania trafiają do modelu w takiej postaci, w jakiej je wysyłasz; PopNow nie dodaje własnego promptu systemowego. Obowiązują zasady korzystania z danego modelu. Tekst wiadomości nie jest przechowywany po rozliczeniu opłaty.

Powiązane