Generación y edición de imágenes

POST/v1/media/images

Endpoint de imágenes propio: un único endpoint para texto-a-imagen e imagen-a-imagen. Solicitud neutral de proveedor, devuelve un envelope media.image. Se factura por imagen según el nivel de tamaño × calidad.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`model`	string	Sí	Modelo de imagen a usar (de GET /v1/models).
`prompt`	string	Sí	Descripción textual de la imagen deseada.
`images`	string or array	No	Imagen(es) de entrada para imagen-a-imagen: una URL o data URI base64, una o varias. Omite para texto-a-imagen. (También se acepta el alias singular image.)
`n`	integer	No	Número de imágenes a generar. Por defecto: `1`.
`size`	string	No	Resolución de salida, p. ej. 1024x1024. Afecta al nivel de precio. Solo para seedream-5.0-lite: el total de píxeles de salida debe ser de al menos 3.686.400. Valor predeterminado: 2048x2048.
`quality`	string	No	Nivel de calidad, p. ej. standard / hd. Afecta al nivel de precio.
`negative_prompt`	string	No	Prompt negativo: describe lo que se debe evitar.
`seed`	integer	No	Semilla aleatoria para resultados reproducibles.
`response_format`	string	No	Cómo se devuelven las imágenes: url o b64_json. Por defecto: `url`.
`provider_options`	object	No	Interruptores específicos del proveedor (p. ej. watermark, prompt_extend), reenviados al upstream sin cambios.

Ejemplo de solicitud

bash

curl https://api.apexnova-consulting.com/v1/media/images \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-3.0",
    "prompt": "A cat playing guitar in space, cyberpunk style",
    "size": "1024x1024",
    "n": 1
  }'

python

import requests

resp = requests.post(
    "https://api.apexnova-consulting.com/v1/media/images",
    headers={"Authorization": "Bearer sk-xxxxxxxx"},
    json={
        "model": "seedream-3.0",
        "prompt": "A cat playing guitar in space, cyberpunk style",
        "size": "1024x1024",
        "n": 1,
    },
)
result = resp.json()
print(result["data"][0]["url"])

Ejemplo de respuesta

json

{
  "id": "img_...",
  "object": "media.image",
  "model": "seedream-3.0",
  "created": 1234567890,
  "data": [
    { "url": "https://..." }
  ]
}

Imagen-a-imagen (edición)

Incluye images (URLs o base64 de las imágenes de entrada, una o varias) para cambiar a imagen-a-imagen; el resto de campos son iguales que en texto-a-imagen.

bash

curl https://api.apexnova-consulting.com/v1/media/images \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-3.0",
    "prompt": "Turn the sky into a warm sunset",
    "images": ["https://example.com/input.png"],
    "size": "1024x1024"
  }'

Notas

La respuesta es un envelope media.image propio (no el formato de imágenes de OpenAI); analízalo con un cliente HTTP — los helpers de imágenes del SDK de OpenAI no aplican.
Se factura por imagen generada; imagen-a-imagen cuenta además las imágenes de entrada.