Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 9:21 · 16:9 · 21:9 · Por defecto: 1:1 |
background | No | Mantener, quitar o reemplazar el fondo. auto · transparent · opaque · Por defecto: auto |
image_urls | Sí | Fotos para editar o combinar. Di en el prompt qué aporta cada una. |
input_fidelity | No | How closely to keep the look of the source images. low · high · Por defecto: low |
mask_url | No | Pinta la zona que debe cambiar. |
num_outputs | No | Cuántos resultados crear de una vez. ≥ 1 · ≤ 10 · Por defecto: 1 |
output_format | No | Tipo de archivo del resultado. png · jpeg · webp · Por defecto: png |
output_quality | No | Compression quality for JPEG and WebP, from 0 to 100. ≥ 0 · ≤ 100 |
prompt | Sí | Say what to change and what must stay the same. |
quality | No | Más tiempo y precio a cambio de más detalle. low · medium · high · xhigh · max · Por defecto: high |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · 4k · Por defecto: 1k |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| aspect_ratio 1:3 · quality low · resolution 1K | 0,27 | 0,0027 US$ |
| aspect_ratio 3:1 · quality low · resolution 1K | 0,27 | 0,0027 US$ |
| aspect_ratio 21:9 · quality low · resolution 1K | 0,37 | 0,0037 US$ |
| aspect_ratio 9:21 · quality low · resolution 1K | 0,37 | 0,0037 US$ |
| aspect_ratio 1:2 · quality low · resolution 1K | 0,41 | 0,0041 US$ |
| aspect_ratio 2:1 · quality low · resolution 1K | 0,41 | 0,0041 US$ |
| aspect_ratio 1:3 · quality low · resolution 2K | 0,43 | 0,0043 US$ |
| aspect_ratio 3:1 · quality low · resolution 2K | 0,43 | 0,0043 US$ |
| aspect_ratio 16:9 · quality low · resolution 1K | 0,46 | 0,0046 US$ |
| aspect_ratio 9:16 · quality low · resolution 1K | 0,46 | 0,0046 US$ |
| aspect_ratio 2:3 · quality low · resolution 1K | 0,54 | 0,0054 US$ |
| aspect_ratio 3:2 · quality low · resolution 1K | 0,54 | 0,0054 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 1 crédito por imagen (0,01 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de GPT Image 2.5 Sunburst en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model openai/gpt-image-2.5-sunburst/edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "high",
"num_outputs": 1,
"input_fidelity": "low"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de GPT Image 2.5 Sunburst
¿Cuánto cuesta la API de GPT Image 2.5 Sunburst?
GPT Image 2.5 Sunburst cuesta desde 1 crédito (0,01 US$) por imagen con Editar imagen, su tarea más barata. Precios por opción: 1:3 · low · 1K 0,27 créditos por imagen, 3:1 · low · 1K 0,27 créditos por imagen, 21:9 · low · 1K 0,37 créditos por imagen, 9:21 · low · 1K 0,37 créditos por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de GPT Image 2.5 Sunburst en la API?
Pon openai/gpt-image-2.5-sunburst/text-to-image para Crear imagen; openai/gpt-image-2.5-sunburst/edit para Editar imagen en el campo model de POST /jobs/createTask.
¿La transparencia funciona de verdad?
Sí. Con background en transparent y salida PNG o WebP, nuestras pruebas de recorte volvieron con un canal alfa real. Esta opción está disponible en el endpoint de edición; el endpoint de texto a imagen no ofrece un ajuste de fondo.
¿Qué límites tiene la API de GPT Image 2.5 Sunburst?
Resoluciones: 1K · 2K · 4K; Relaciones de aspecto: 1:1 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 +9; Resultados por llamada: 1–10; Imágenes de referencia: 16; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar GPT Image 2.5 Sunburst sin escribir código?
Sí. El Playground ejecuta GPT Image 2.5 Sunburst con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de GPT Image
GPT Image 2.5 Flare tiene las mismas opciones y el mismo precio por imagen, pero está ajustado para la velocidad y suele terminar antes. Sunburst es el de las imágenes finales y las ediciones precisas.
- API de GPT Image 2.5 SunburstEl modelo de OpenAI que prioriza la calidad, hasta 4K y con texto limpioDesde 1 crédito por imagen
- API de GPT Image 2.5 FlareEl modelo de OpenAI que prioriza la velocidad, con ediciones por máscara y recortesDesde 1 crédito por imagen
- API de GPT Image 2Texto legible dentro de la imagen y ediciones precisas con máscaraDesde 1 crédito por imagen

