Docs/SparkPix API

SparkPix API

Os modelos de imagem ultrarrápidos da SparkPix com dois endpoints distintos. O SparkPix Image gera texto para imagem em menos de 1 segundo com suporte a estilos personalizados LoRA. O SparkPix Image Edit suporta edição com referência de múltiplas imagens. Ambos são APIs síncronas que retornam os resultados diretamente.

Autenticação

Authorization: Bearer YOUR_API_KEY

Models & pricing

Model	Endpoint	Price	Notas
SparkPix Image	POST /api/v1/images/generations-sync	$0.0100/imagem	Texto para imagem, síncrono, <1s, suporte a LoRA
SparkPix Image Edit	POST /api/v1/images/edit	$0.0130/imagem	Edição com várias imagens, síncrono, <1s

Code examples

# SparkPix Image: Text-to-image (sync, sub-1-second)
curl -X POST https://apimodels.app/api/v1/images/generations-sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cute cat wearing a space helmet, digital art",
    "aspect_ratio": "16:9",
    "seed": 42
  }'

# SparkPix Image Edit: Multi-image editing (sync)
curl -X POST https://apimodels.app/api/v1/images/edit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Make the background a sunset beach",
    "images": ["https://example.com/photo.jpg"],
    "aspect_ratio": "16:9"
  }'

SparkPix Image — Parâmetros da requisição

POST /api/v1/images/generations-sync

Field	Required	Type	Description
prompt	Yes	string	Descrição de texto para a geração de imagens
aspect_ratio	No	string	"custom" (padrão, tamanho automático), "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"
width	No	integer	Apenas quando aspect_ratio="custom", 256-1440, deve ser múltiplo de 16
height	No	integer	Apenas quando aspect_ratio="custom", 256-1440, deve ser múltiplo de 16
prompt_upsampling	No	boolean	Aprimorar automaticamente o prompt com LLM (padrão: false)
seed	No	integer	Semente aleatória para reprodutibilidade
lora_weights	No	string	URL dos pesos LoRA do HuggingFace, formato: huggingface.co/<owner>/<model>[/<file.safetensors>]
lora_scale	No	number	Intensidade do LoRA, de -1 a 3, padrão 0.5
callBackUrl	No	string	URL do webhook chamada quando a tarefa é concluída

SparkPix Image Edit — Parâmetros da requisição

POST /api/v1/images/edit

Field	Required	Type	Description
prompt	Yes	string	Instruções de edição. Refira-se às entradas como "image 1", "image 2", etc.
images	No	string[]	Array de URLs de imagens de referência; a primeira imagem é a principal
aspect_ratio	No	string	"match_input_image" (padrão, corresponde à primeira imagem), "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"
turbo	No	boolean	Modo turbo (padrão: true), recomendado desativar para tarefas complexas
seed	No	integer	Semente aleatória para reprodutibilidade
callBackUrl	No	string	URL do webhook chamada quando a tarefa é concluída

Notas

Os dois modelos usam endpoints de API diferentes
Ambas são APIs síncronas que retornam as URLs das imagens diretamente, sem necessidade de polling
Formato da resposta: { code: 200, data: { url, model, credits, duration } }
No SparkPix Image, aspect_ratio assume o padrão "custom" (automático); no SparkPix Image Edit, o padrão é "match_input_image"

Try it in the Playground

Perguntas frequentes

How fast is SparkPix?

SparkPix Image generates text-to-image in under 1 second and both endpoints are synchronous — the image URL comes back in the same response, no polling.

Which endpoint do I use for editing vs generation?

Text-to-image: POST /api/v1/images/generations-sync. Editing: POST /api/v1/images/edit with images[] (first image is the primary). They are separate endpoints.