聊天模型

PopNow API 也提供聊天模型：Claude、Gemini、DeepSeek、GLM、Grok 和 Kimi。透過你已經在用的協定呼叫——OpenAI Chat Completions 與 Responses、Anthropic Messages、Gemini generateContent——修改基底網址後即可繼續使用官方 SDK。它們與 API 圖片、影片和音訊共用 sk-popnow- 金鑰，以及獨立的 API 美元餘額。餘額初始為 $0，請在 API 帳單儲值；網站點數不能支付這些呼叫。

聊天呼叫是同步的：回覆（或串流）在同一個回應中回傳，沒有需要輪詢的任務。

概覽

第一個聊天請求

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

回覆是標準的 chat.completion 物件，包含 choices[0].message.content 和 usage。回應標頭 X-PopNow-Task-Id 提供紀錄這筆收費的任務。

OpenAI SDK

把用戶端指向 https://api.popnow.ai/v1，並傳入你的 PopNow 金鑰即可，其他都不用改。

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

Responses API（client.responses.create）也可以用，但只能是無狀態形式：每次都要在 input 裡傳送完整的對話。傳入 previous_response_id 會回傳 400。

Anthropic SDK

Anthropic SDK 會自己加上 /v1/messages，所以 base URL 不帶 /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)

這個端點上的任何聊天模型都能用，不只是 Claude。錯誤以 Anthropic 的 {"type": "error", "error": {...}} 格式回傳。

Gemini generateContent

把完整的模型 ID 放在路徑裡；它可以包含斜線。

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

需要串流輸出時，使用 :streamGenerateContent?alt=sse。錯誤使用 Google 的 {"error": {"code", "message", "status"}} 格式。

串流輸出

設定 stream: true，然後讀取 Server-Sent Events。在 Chat Completions 上，每個資料區塊都是 chat.completion.chunk，串流以 data: [DONE] 結束。和 OpenAI 一樣，串流中預設不包含 usage，除非你用 stream_options: { "include_usage": true } 要求回傳；此時用量會在最後一個資料區塊中回傳，並附上空的 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="")

工具、JSON 輸出與參數

每個模型都宣告了它接受的請求欄位，例如 tools、tool_choice、response_format、temperature、reasoning_effort 等。模型表中的參數欄列出了這些欄位，GET /v1/models 則會在 supported_parameters 中回傳它們。

• 模型不支援的取樣參數（temperature、top_p、frequency_penalty 等）會被丟棄，而不是直接報錯，並在 X-PopNow-Ignored-Params 回應標頭中列出。
• 超出模型取值範圍的值會被調整為最接近的可接受值，並以 name=value 的形式出現在 X-PopNow-Adjusted-Params 中。
• 模型未宣告的其他欄位會回傳 400，附帶 code: unsupported_parameter，param 指明是哪個欄位；例如把圖片內容塊發給純文字模型。

模型與價格

按每 100 萬 token的美元價格計，輸入和輸出分別定價；支援快取的模型，快取輸入更便宜。有些模型在請求超過長上下文門檻後會使用較高價格，門檻標在模型名稱下方。

同樣的清單也可以透過 API 取得，包含價格、上下文長度和支援的參數：

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

聊天請求如何計費

1. 保留。 請求被受理時，系統會根據輸入和 max_tokens 估算最高費用，並從餘額中保留這筆金額。如果你不設定 max_tokens，會按模型的最大輸出計算，所以請設定它，以減小保留額。
2. 收費。 回覆結束後，按實際使用的 token 以美元結算，沒有單次請求最低消費。其餘保留金額釋放。
3. 退款。 失敗的請求，或被模型拒絕的請求，會全額退款。

餘額不足以支付保留金額，或會超過金鑰的消費上限時，請求在送到模型前就回傳 402。要查看確切費用，以回應標頭 X-PopNow-Task-Id 中的任務 ID 查詢 GET /api/v1/jobs/recordInfo：costUsd 是用於顯示與對帳的美元十進位字串。回應裡可能仍有舊點數欄位；不要把美元費用以整數點數進位。

長回覆與錯誤

• 長時間的非串流呼叫。 如果回覆超過約 30 秒，會先傳送 200 狀態和 X-PopNow-Keepalive: 1 回應標頭，之後每 15 秒傳送一個換行，最後才是 JSON 內容。在那之後發生的失敗，會以協定常規的錯誤物件出現在 200 內容中，所以當該回應標頭存在時，請檢查是否有 error 鍵。串流呼叫可以避免這個問題。
• 404 model_not_found。 模型 ID 不存在。錯誤訊息會提供你可以呼叫的最接近的聊天模型。
• 400 且 param: model。 這個 ID 屬於圖片、影片或音訊模型；這些模型以任務的形式執行。
• 400 content_rejected。 模型自身的內容政策拒絕了這個請求。不收費。
• 402。 API 美元餘額不足以保留所需金額，或達到金鑰消費上限。請見 API 計費。

隱私

請求會按你編寫的原樣傳送給模型；PopNow 不會新增自己的系統提示詞。每個模型自己的使用政策同樣適用。費用結算後，訊息內容不會被保留。

相關