Introdução
O P-H3-Image Texto para imagem converte sua descrição de cena em uma imagem estática. A Pruna AI lançou seus pesos abertos em 3 de novembro de 2026, adaptando o MiniMax H3 para geração e edição de imagens.
Recursos e destaques
Escolha 1k, 1.5k, 2k, 3k ou 4k independentemente das 15 proporções. Nos nossos testes, a opção 4k em 16:9 produziu 5472 x 3072 pixels. Você pode receber o resultado em JPEG, PNG ou WebP.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | A descrição da cena é obrigatória e não tem texto padrão. Descreva roupa, cenário e luz de forma concisa, sem uma lista extensa de adjetivos. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Escolha entre 15 proporções: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9. Se omitida, a geração usa 1:1; a escolha não altera o preço do nível. |
resolution | Não | Selecione 1k (padrão, cerca de 1 MP), 1.5k (~2,4 MP), 2k (~4 MP), 3k (~9,4 MP) ou 4k (~16,8 MP). Este campo define o nível de tamanho usado na cobrança. |
output_format | Não | O formato do arquivo é jpeg por padrão; png e webp são os outros valores aceitos. Escolher um formato não acrescenta taxa. |
seed | Não | Configuração opcional da fonte aleatória, sem valor fixo obrigatório. Reutilize-a ao alterar uma única configuração para comparar os resultados; a saída idêntica não é garantida. |
Preços
Cada imagem gerada é cobrada pelo nível de tamanho escolhido: 1k, 1.5k, 2k, 3k ou 4k. Proporção e formato não acrescentam taxas. No modo de edição, cada imagem de origem além da primeira gera uma pequena cobrança. Requisições que falham não são cobradas.
| Especificação | Preço |
|---|---|
| $0.024 / imagem |
| $0.036 / imagem |
| $0.048 / imagem |
| $0.096 / imagem |
| $0.144 / imagem |
Casos de uso
Descreva cenas para retratos editoriais, imagens de lanchonete com visual de filme ou letreiros curtos de neon. Para alterar imagens existentes, use Edição de imagem.
Guia de prompt e dicas práticas
Informe sujeito, roupa, lugar e fonte de luz. A Pruna AI diz que palavras curtas entre aspas podem ser renderizadas, mas trechos longos e letras pequenas podem virar texto sem sentido. Mantenha seed ao mudar um elemento para comparar os resultados; isso não fixa a saída. Nos nossos testes, os níveis maiores demoraram mais, com uma geração em 4k chegando a 241 segundos de processamento do modelo.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pruna-ai/p-h3-image/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
