Modelos

Cada modelo que você pode chamar tem um ID de modelo, que vai no campo model do createTask. A tabela no fim desta página lista todos com o preço inicial; cada nome leva a uma página de referência com a lista completa de parâmetros, as faixas de preço e uma requisição pronta para copiar.

Como um ID de modelo é formado

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker é quem criou o modelo. As ferramentas feitas pela própria PopNow usam popnow.
• model mantém os pontos da versão: seedance-2.0, não seedance-2-0.
• task diz o que a chamada faz: text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio e assim por diante. Edição de imagem é sempre edit.

Uma família de modelos costuma ter vários IDs, um por tarefa. Escolha o que combina com o que você envia: .../text-to-video só precisa de prompt; .../image-to-video precisa de uma imagem inicial.

Leia o catálogo pelo código

Quem manda é o catálogo ao vivo: ele traz o que está disponível agora e os preços que valem para a sua conta.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Filtros da lista: modality (image, video, audio), provider, task, search, além de includeSchema=1 e includeExamples=1 para incluir schemas de entrada e exemplos de entrada validados. Se o seu cliente HTTP trata um parâmetro de caminho como um único segmento, codifique as barras como %2F.

Campos que valem a leitura

Lendo preços

credits é o mesmo preço que aparece no popnow.ai, em créditos (1 crédito = US$ 0,01):

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit diz como o preço escala (per_image, per_second, per_request, per_1k_characters), perUnit é o preço inicial e cada regra vale quando a requisição bate com os valores de when (* representa a configuração que define a faixa, aqui resolution). A cobrança final de uma tarefa é arredondada para cima em créditos inteiros.

Para o valor exato de uma requisição específica, pergunte ao jobs/quote com o mesmo corpo que você mandaria ao createTask.

Schemas de entrada

inputSchema é JSON Schema padrão (draft 2020-12). Algumas regras valem para todos os modelos:

• Campos desconhecidos são rejeitados. Um aspect_ration digitado errado retorna 400 em vez de ser ignorado em silêncio.
• Os nomes de campo são iguais entre modelos. A mesma ideia sempre tem o mesmo nome: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• Os valores padrão são preenchidos para você. Envie só o que quiser mudar.
• Campos de mídia aceitam uma URL HTTPS pública, um arquivo popnow:// que você enviou ou um asset salvo. Veja Mídia.
• Dicas de exibição ficam num objeto x-ui em cada propriedade (rótulos, ordem, passo dos controles deslizantes). Elas nunca mudam a validação; ignore as chaves que você não conhece.

Se você omitir seed num modelo que tem esse campo, um valor aleatório é escolhido e devolvido no input da tarefa, para você repetir um resultado de que gostou.

Cache

As respostas do catálogo são privadas da sua conta e podem ficar em cache por 60 segundos. Um bom padrão: guardar a lista por alguns minutos, ler um modelo de novo quando a version dele mudar e tratar available: false como "tente mais tarde ou escolha outro modelo".

Todos os modelos que você pode chamar

Os preços são a faixa mais baixa por unidade; resoluções maiores, clipes mais longos e opções extras custam mais. A página de cada modelo mostra todas as faixas.