Modelos de chat

A API PopNow também executa modelos de chat: Claude, Gemini, DeepSeek, GLM, Grok e Kimi. Você os chama pelos protocolos que o seu código já fala — OpenAI Chat Completions e Responses, Anthropic Messages e generateContent do Gemini —, então os SDKs oficiais funcionam assim que você troca a URL base. Eles usam a mesma chave sk-popnow- e o mesmo saldo separado da API em USD das imagens, dos vídeos e dos áudios da API. Ele começa em $0; adicione fundos em API billing. Créditos do site não financiam essas chamadas.

As chamadas de chat são síncronas: você recebe a resposta (ou um stream) na mesma resposta HTTP. Não há tarefa para consultar.

Visão geral

Sua primeira requisição de chat

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

A resposta é um objeto chat.completion padrão, com choices[0].message.content e usage. O cabeçalho de resposta X-PopNow-Task-Id indica a tarefa que registrou a cobrança.

SDK da OpenAI

Aponte o cliente para https://api.popnow.ai/v1 e passe a sua chave da PopNow. Nada mais muda.

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

A API Responses (client.responses.create) também funciona, na forma sem estado: envie a conversa inteira em input a cada vez. previous_response_id retorna 400.

SDK da Anthropic

O SDK da Anthropic acrescenta /v1/messages por conta própria, então a URL base não tem /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)

Qualquer modelo de chat funciona neste endpoint, não só o Claude. Os erros voltam no formato {"type": "error", "error": {...}} da Anthropic.

Gemini generateContent

Coloque o ID completo do modelo no caminho; ele pode conter barras.

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

Use :streamGenerateContent?alt=sse para receber um stream. Os erros seguem o formato {"error": {"code", "message", "status"}} do Google.

Streaming

Defina stream: true e leia os Server-Sent Events. No Chat Completions, cada bloco é um chat.completion.chunk e o stream termina com data: [DONE]. Como na OpenAI, um stream não traz usage a menos que você peça com stream_options: { "include_usage": true }; nesse caso, o uso chega em um último bloco com um array choices vazio.

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

Ferramentas, saída JSON e parâmetros

Cada modelo declara os campos de requisição que aceita — tools, tool_choice, response_format, temperature, reasoning_effort e assim por diante. A coluna Parameters da tabela de modelos os lista, e GET /v1/models os devolve em supported_parameters.

• Uma configuração de amostragem que o modelo não aceita (temperature, top_p, frequency_penalty …) é descartada em vez de falhar, e aparece no cabeçalho de resposta X-PopNow-Ignored-Params.
• Um valor fora da faixa do modelo é ajustado para o valor aceito mais próximo e informado em X-PopNow-Adjusted-Params como name=value.
• Qualquer outro campo que o modelo não declara retorna 400 com code: unsupported_parameter e param indicando o campo, por exemplo uma parte de imagem enviada a um modelo somente de texto.

Modelos e preços

Use preços em USD por 1 milhão de tokens, para entrada e saída separadamente; a entrada em cache é mais barata nos modelos que fazem cache. Alguns modelos cobram uma taxa maior quando a requisição passa de um limite de contexto longo, mostrado abaixo do nome do modelo.

A mesma lista está disponível pela API, com preços, tamanho de contexto e parâmetros aceitos:

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

Como uma requisição de chat é cobrada

1. Reserva. Quando a requisição é aceita, o máximo que ela pode custar é separado do seu saldo, calculado a partir da entrada e de max_tokens. Se você deixar max_tokens de fora, usa-se a saída máxima do modelo; por isso, defina-o para manter as reservas pequenas.
2. Cobrança. Quando a resposta termina, você paga pelos tokens realmente usados, em USD, sem mínimo por requisição. O restante da reserva é liberado.
3. Reembolso. Uma requisição que falha, ou que o modelo recusa, é reembolsada integralmente.

Um saldo menor que a reserva, ou uma chave com um limite de gasto que seria ultrapassado, retorna 402 antes de qualquer coisa ser enviada ao modelo. Para ver a cobrança exata, leia a tarefa indicada em X-PopNow-Task-Id com GET /api/v1/jobs/recordInfo: costUsd é a string decimal em USD a mostrar e usar na contabilidade. Campos antigos de créditos também podem aparecer; não arredonde cobranças em USD para créditos inteiros.

Respostas longas e erros

• Chamadas longas sem streaming. Se a resposta demorar mais de cerca de 30 segundos, são enviados primeiro o status 200 e um cabeçalho X-PopNow-Keepalive: 1, depois uma quebra de linha a cada 15 segundos, e por fim o corpo JSON. Uma falha depois desse ponto chega como o objeto de erro habitual do protocolo dentro do corpo 200; por isso, quando esse cabeçalho estiver presente, verifique se há uma chave error. O streaming evita isso.
• 404 model_not_found. O ID do modelo não existe. O erro indica o modelo de chat mais próximo que você pode chamar.
• 400 com param: model. O ID pertence a um modelo de imagem, vídeo ou áudio; esses rodam como tarefas.
• 400 content_rejected. A política de conteúdo do próprio modelo recusou a requisição. Nada é cobrado.
• 402. USD insuficientes na API para a reserva, ou limite de gasto da chave. Veja Cobrança da API.

Privacidade

As requisições são enviadas ao modelo exatamente como você as escreveu; a PopNow não acrescenta prompt de sistema próprio. A política de uso de cada modelo se aplica. O texto das mensagens não é guardado depois que a cobrança é liquidada.

Relacionados