Aparência
Catálogo de Modelos
A Pixapi expõe múltiplas famílias de modelos por trás de uma chave de API. Escolha um ID de modelo, passe-o no corpo da requisição compatível com OpenAI e mantenha o resto de sua integração estável enquanto compara provedores.
Modelos de imagem
A geração de imagens usa POST /v1/images/generations. A edição de imagens usa POST /v1/images/edits quando o modelo suporta imagens de entrada. Use n, size e controles opcionais como quality. Para saídas grandes ou modelos mais lentos, envie por /v1/async/images/generations ou /v1/async/images/edits e depois consulte GET /v1/tasks/{id}.
| Modelo | ID do modelo | Melhor para | Endpoints | Créditos |
|---|---|---|---|---|
| Gemini 2.5 Flash Image | gemini-2.5-flash-image | Geração e edição rápida de imagens Gemini | Gerar, editar | 2 |
| Gemini 3.1 Flash Lite Image | gemini-3.1-flash-lite-image | Fluxos Gemini 3.1 Flash Lite Image de baixo custo otimizados para velocidade e escala | Gerar, editar | 2 |
| Gemini 3.1 Flash Image Preview | gemini-3.1-flash-image-preview | Geração de imagens Gemini equilibrada com controle de proporção | Gerar, editar | a partir de 4 |
| Gemini 3 Pro Image Preview | gemini-3-pro-image-preview | Geração e edição premium com controle de proporção | Gerar, editar | a partir de 8 |
| GPT Image 1.5 | gpt-image-1.5 | Geração e edição de imagens GPT com forte renderização de texto | Gerar, editar | a partir de 1 |
| GPT Image 2 | gpt-image-2 | Níveis de qualidade OpenAI, tamanhos personalizados, aderência ao prompt | Gerar, editar | a partir de 1 |
Modelos de vídeo
| Modelo | Model id | Ideal para | Endpoint | Créditos |
|---|---|---|---|---|
| Veo | veo3.1-lite / veo3.1-fast / veo3.1-quality | Movimento realista e clips de produto cinematográficos | /v1/async/videos/generations | a partir de 4/s |
| Seedance | seedance-2 / seedance-2-fast / seedance-2-mini | Áudio sincronizado, primeiros/últimos frames, referências multimodais | /v1/async/videos/generations | a partir de 4/s |
| Kling | kling-3.0-turbo / kling-v3 / kling-v3-omni | Movimento expressivo e controle de sujeito | /v1/async/videos/generations | a partir de 6/s |
| Wan | wan2.6 / wan2.6-flash | Cenas criativas e transições de câmera | /v1/async/videos/generations | a partir de 5/s |
| Grok Video | grok-video-3 / grok-video-1.5-preview | Clips curtos a partir de texto ou imagem | /v1/async/videos/generations | a partir de 5/s |
| HappyHorse | happyhorse-1.1 | Fluxos texto/imagem/referência/edição | /v1/async/videos/generations | a partir de 13/s |
Dedução de créditos
Requisições de imagem Gemini são cobradas por modelo selecionado e nível de saída.
| ID do modelo | Créditos / imagem |
|---|---|
gemini-2.5-flash-image | 2 |
gemini-3.1-flash-lite-image | 2 |
gemini-3.1-flash-image-preview-512 | 4 |
gemini-3.1-flash-image-preview | 4 |
gemini-3.1-flash-image-preview-2k | 6 |
gemini-3.1-flash-image-preview-4k | 8 |
gemini-3-pro-image-preview | 8 |
gemini-3-pro-image-preview-2k | 8 |
gemini-3-pro-image-preview-4k | 16 |
O GPT Image 2 é cobrado por nível de tamanho de saída e qualidade. quality=auto é cobrado como high, e size=auto usa o nível 1K por padrão.
| Nível de tamanho | Lado maior | low | medium | high / auto |
|---|---|---|---|---|
| 1K | <= 1536px | 1 | 4 | 14 |
| 2K | <= 2048px | 2 | 17 | 67 |
| 4K | <= 3840px | 4 | 34 | 133 |
Modelos de vídeo são cobrados pela duração gerada com sucesso. Veja cada linha para a taxa por segundo.
Os modelos de vídeo são cobrados como n × seconds × rate(resolution). Veja a página de cada modelo para os valores permitidos de seconds / resolution.
A geração de vídeo é apenas assíncrona. Use /v1/async/videos/generations e o fluxo de tarefas de mídia assíncronas.
| Model / tier | Pixapi credits |
|---|---|
veo3.1-lite 720P / 1080P | 4/sec / 7/sec |
veo3.1-fast 720P / 1080P / 4K | 8/sec / 10/sec / 24/sec |
veo3.1-quality 720P·1080P / 4K | 32/sec / 48/sec |
seedance-2-mini 480P / 720P | 4/sec / 8/sec |
seedance-2-fast 480P / 720P | 6/sec / 13/sec |
seedance-2 480P / 720P / 1080P / 4K | 8/sec / 16/sec / 38/sec / 78/sec |
kling-3.0-turbo 720P / 1080P | 6/sec / 8/sec |
kling-v3 / kling-v3-omni 720P / 1080P | 9/sec / 12/sec |
wan2.6-flash 720P / 1080P | 5/sec / 8/sec |
wan2.6 720P / 1080P | 9/sec / 15/sec |
grok-video-3 480P / 720P | 5/sec / 7/sec |
grok-video-1.5-preview 480P / 720P | 8/sec / 14/sec |
happyhorse-1.1 720P / 1080P | 13/sec / 18/sec |
Escolhendo um modelo
- Use
gemini-3.1-flash-lite-imagepara fluxos Gemini 3.1 Flash Lite Image com maior velocidade e menor custo. - Use
gemini-2.5-flash-imagepara fluxos rápidos legados do formato anterior de geração de imagens. - Use
gemini-3.1-flash-image-previewquando precisar de um modelo de preview Gemini equilibrado com controle de proporção. - Use
gemini-3-pro-image-previewquando a qualidade importa mais do que o custo. - Use
gpt-image-2quando aderência ao prompt, tipografia, tamanho personalizado ou precisão de layout importam. - Use
veo3.1-lite,veo3.1-fastouveo3.1-qualityquando precisar de movimento, câmera e timing de vídeo. - Use
seedance-2para áudio sincronizado, primeiros/últimos frames ou referências multimodais. - Use
kling-3.0-turbopara Kling econômico, oukling-v3/kling-v3-omnipara maior qualidade. - Use
wan2.6/wan2.6-flash,grok-video-3ouhappyhorse-1.1para outros provedores no mesmo endpoint async.
Padrão de integração estável
O endpoint normalmente permanece o mesmo para um tipo de mídia. A troca de modelos é normalmente uma alteração no corpo da requisição:
json
{
"model": "gemini-3-pro-image-preview",
"prompt": "A clean product hero image for a developer API platform",
"n": 1,
"size": "1:1"
}Os campos do formato anterior de geração de imagens legado estão separados em Formato de transição legado.
