Aparência
Gemini 3.1 Flash Lite Image
gemini-3.1-flash-lite-image é o modelo de imagem Gemini 3.1 Flash Lite Image do Google. Ele é otimizado para velocidade, escala e baixo custo quando latência e preço são as principais restrições.
O Google indica que este modelo Lite não é otimizado para múltiplas entradas de referência nem para edição sequencial em múltiplos turnos. Use-o para geração 1K rápida e edições simples; use gemini-3.1-flash-image-preview quando consistência de referência ou mais níveis de saída forem mais importantes.
Superfície da API
| Operação | Endpoint | Modo |
|---|---|---|
| Geração de imagens | POST /v1/images/generations | Síncrono |
| Tarefa de geração de imagens | POST /v1/async/images/generations | Assíncrono |
| Edição de imagens | POST /v1/images/edits | Síncrono |
| Tarefa de edição de imagens | POST /v1/async/images/edits | Assíncrono |
Preços
| ID do modelo | Nível de saída | Créditos / imagem |
|---|---|---|
gemini-3.1-flash-lite-image | 1K | 2 |
Campos de requisição
Este modelo usa os mesmos campos de imagem compatíveis com OpenAI do restante da Pixapi.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model | string | Sim | Use gemini-3.1-flash-lite-image. |
prompt | string | Sim | Descreva a imagem ou edição desejada. |
image | string ou string[] | Obrigatório para edições | URL da imagem de entrada. Para este modelo Lite, prefira uma única imagem de referência. |
n | number | Não | Número de imagens a retornar. Atualmente, apenas 1 é suportado. |
size | string | Não | Proporção de saída: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ou 21:9. |
Exemplo
bash
curl https://api.pixapi.ai/v1/images/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-lite-image",
"prompt": "A polished product photo of a ceramic coffee cup",
"n": 1,
"size": "1:1"
}'py
import os
import requests
response = requests.post(
"https://api.pixapi.ai/v1/images/generations",
headers={
"Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "gemini-3.1-flash-lite-image",
"prompt": "A polished product photo of a ceramic coffee cup",
"n": 1,
"size": "1:1"
},
)
response.raise_for_status()
print(response.json())js
const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "gemini-3.1-flash-lite-image",
"prompt": "A polished product photo of a ceramic coffee cup",
"n": 1,
"size": "1:1"
}),
});
if (!response.ok) {
throw new Error(await response.text());
}
console.log(await response.json());go
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{
"model": "gemini-3.1-flash-lite-image",
"prompt": "A polished product photo of a ceramic coffee cup",
"n": 1,
"size": "1:1"
}`)
req, err := http.NewRequest(
"POST",
"https://api.pixapi.ai/v1/images/generations",
bytes.NewBuffer(body),
)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}Para o formato de resposta compartilhado e exemplo de upload de edição, consulte a Referência da API.
