Listar modelos
GET /v1/models
Devolve os modelos de imagem e vídeo disponíveis neste momento. Só aparecem os que têm credenciais configuradas e estão ativos, por isso a lista pode mudar: obtém-na no arranque da aplicação em vez de fixares ids no código.
Pedido
bash
curl https://open.pikpikgo.com/v1/models \
-H "Authorization: Bearer $PIKPIK_API_KEY"Resposta
json
{
"object": "list",
"data": [
{
"id": "img-std-1",
"object": "model",
"type": "image",
"credits": 10,
"max_reference_images": 4,
"specs": [
{ "key": "2k", "name": "2K", "resolution": "2k", "quality": "2k", "credits": 10, "min_sec": 0, "max_sec": 0 }
]
}
]
}Campos
| Campo | Descrição |
|---|---|
| id | Identificador do modelo. É o valor a passar em model; um id que não esteja nesta lista é recusado em vez de ser trocado em silêncio pelo predefinido |
| type | image, video ou text |
| credits | Preço unitário. Por imagem nos modelos de imagem; por pedido nos modelos de vídeo sem níveis |
| max_reference_images | Quantas imagens de referência aceita. 0 significa não suportado |
| aspect_ratios | Apenas vídeo. Proporções que este modelo aceita; um array vazio significa sem restrição. Qualquer proporção fora da lista é recusada |
| supports_last_frame | Apenas vídeo. false significa que o modelo só aceita o primeiro fotograma; passar image_last é recusado |
| max_reference_videos | Apenas vídeo. Quantos vídeos de referência aceita. 0 significa não suportado |
| max_reference_audios | Apenas vídeo. Quantos áudios de referência aceita. 0 significa não suportado |
| specs | Níveis disponíveis. Ao passar spec, a resolução e o preço vêm do nível |
| specs[].credits | Preço de vídeo: billing=per_sec multiplica pela duração; billing=per_unit não |
| specs[].min_sec / max_sec | Intervalo de duração permitido em segundos. Valores fora do intervalo são ajustados |
Na imagem e no vídeo, sem model é usado o modelo predefinido da plataforma, que pode mudar com o tempo: indica-o explicitamente se precisas de estabilidade. As entradas com type text servem o /v1/chat/completions, onde model é obrigatório e não tem predefinição.