Introdução
O P-H3-Image Edição de imagem usa a primeira imagem como origem e aceita até oito referências adicionais. Uma instrução de texto indica ao modelo quais elementos manter ou substituir.
Recursos e destaques
Identifique a origem como <Picture 1> e a entrada seguinte como <Picture 2>. Por padrão, a saída segue a proporção da primeira imagem; definir aspect_ratio substitui essa proporção. Os cinco níveis de resolução também estão disponíveis para edição. Nos nossos testes, uma edição em 4k retornou 3360 x 5024 pixels.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Informe a instrução de edição obrigatória, que não tem valor padrão. Diga o que mudar e o que manter, identificando as imagens por número ao combinar fontes. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | Lista obrigatória e ordenada de 1–9 URLs de imagens, sem origem padrão. pelo menos 1 itens · no máximo 9 itens |
aspect_ratio | Não | Omita este campo opcional para herdar a proporção da primeira imagem. |
resolution | Não | A edição usa 1k por padrão, cerca de 1 megapixel. As alternativas são 1.5k (~2,4 MP), 2k (~4 MP), 3k (~9,4 MP) e 4k (~16,8 MP); mudar o nível altera a tarifa da imagem. |
output_format | Não | A edição é salva em jpeg, a menos que você solicite png ou webp. Os três formatos têm o mesmo preço. |
seed | Não | Você pode informar um valor para a fonte aleatória ao comparar edições; nenhum é exigido por padrão. |
Preços
A imagem editada é cobrada pelo nível escolhido entre 1k, 1.5k, 2k, 3k e 4k. Cada imagem de entrada depois da primeira acrescenta uma pequena taxa; a proporção e o formato de saída não geram acréscimo. Requisições com falha não são faturadas.
| Especificação | Preço |
|---|---|
| $0.03 / imagem |
| $0.048 / imagem |
| $0.066 / imagem |
| $0.138 / imagem |
| $0.21 / imagem |
Casos de uso
Use um retrato para criar uma nova roupa em um cenário à beira-mar ou combine uma foto de palco com outra artista. Nossos testes com uma e duas fontes preservaram a identidade solicitada durante as mudanças de cena.
Guia de prompt e dicas práticas
Coloque a cena a preservar na primeira posição e depois indique quais detalhes vêm de cada entrada numerada. Nos nossos testes, inverter essa ordem gerou um resultado mais próximo da outra cena. Cada referência além da primeira acrescenta uma pequena taxa. Segundo a Pruna AI, resoluções menores podem apresentar mais artefatos nos detalhes.
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/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
