Docs/SparkPix API

SparkPix API

Los modelos de imagen ultrarrápidos de SparkPix con dos endpoints distintos. SparkPix Image genera texto a imagen en menos de 1 segundo con soporte de estilos personalizados LoRA. SparkPix Image Edit admite la edición con referencia de múltiples imágenes. Ambos son APIs síncronas que devuelven los resultados directamente.

Autenticación

Authorization: Bearer YOUR_API_KEY

Models & pricing

Model	Endpoint	Price	Notas
SparkPix Image	POST /api/v1/images/generations-sync	$0.0100/imagen	Texto a imagen, síncrono, <1s, compatible con LoRA
SparkPix Image Edit	POST /api/v1/images/edit	$0.0130/imagen	Edición multi-imagen, 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 de la solicitud

POST /api/v1/images/generations-sync

Field	Required	Type	Description
prompt	Yes	string	Descripción de texto para la generación de imágenes
aspect_ratio	No	string	"custom" (predeterminado, tamaño automático), "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"
width	No	integer	Solo cuando aspect_ratio="custom", 256-1440, debe ser múltiplo de 16
height	No	integer	Solo cuando aspect_ratio="custom", 256-1440, debe ser múltiplo de 16
prompt_upsampling	No	boolean	Mejorar automáticamente el prompt con LLM (predeterminado: false)
seed	No	integer	Semilla aleatoria para la reproducibilidad
lora_weights	No	string	URL de los pesos LoRA de HuggingFace, formato: huggingface.co/<owner>/<model>[/<file.safetensors>]
lora_scale	No	number	Intensidad de LoRA, de -1 a 3, predeterminado 0.5
callBackUrl	No	string	URL del webhook que se invoca cuando la tarea finaliza

SparkPix Image Edit — Parámetros de la solicitud

POST /api/v1/images/edit

Field	Required	Type	Description
prompt	Yes	string	Instrucciones de edición. Refiérete a las entradas como "image 1", "image 2", etc.
images	No	string[]	Array de URLs de imágenes de referencia; la primera imagen es la principal
aspect_ratio	No	string	"match_input_image" (predeterminado, coincide con la primera imagen), "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"
turbo	No	boolean	Modo turbo (predeterminado: true), se recomienda desactivarlo para tareas complejas
seed	No	integer	Semilla aleatoria para la reproducibilidad
callBackUrl	No	string	URL del webhook que se invoca cuando la tarea finaliza

Notas

Los dos modelos usan endpoints de API diferentes
Ambas son APIs síncronas que devuelven las URLs de las imágenes directamente, sin necesidad de sondeo
Formato de respuesta: { code: 200, data: { url, model, credits, duration } }
En SparkPix Image, aspect_ratio toma el valor predeterminado "custom" (automático); en SparkPix Image Edit, el predeterminado es "match_input_image"

Try it in the Playground

Preguntas frecuentes

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.