Skip to content

Generación y edición de imágenes

La API de imágenes permite crear imágenes desde texto y editar archivos existentes. Modelo, tamaño, calidad y formato de entrada modifican el precio; las ediciones usan multipart/form-data.

  • Usa /v1/images/generations para crear y /v1/images/edits para editar.
  • Comprueba los valores size, quality, cantidad y límites de archivo admitidos por cada modelo.
  • El cargo final corresponde al resultado completado y al uso devuelto; un trabajo fallido no debe cobrarse como éxito.

Ejemplos completos

A continuación se conservan todos los ejemplos ejecutables de la guía original. Ejecuta únicamente los bloques que correspondan a tu herramienta y sistema operativo.

bash
curl https://nordrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "modalities": ["image", "text"],
    "messages": [{ "role": "user", "content": "A cozy cabin in the woods, watercolor" }]
  }'
python
from openai import OpenAI

client = OpenAI(base_url="https://nordrouter.com/v1", api_key="sk-nr-YOUR-KEY")

resp = client.chat.completions.create(
    model="google/gemini-3.1-flash-image-preview",
    modalities=["image", "text"],
    messages=[{"role": "user", "content": "A cozy cabin in the woods, watercolor"}],
)
img_b64 = resp.choices[0].message.images[0]["image_url"]["url"]  # data:image/png;base64,...
python
resp = client.chat.completions.create(
    model="google/gemini-3.1-flash-image-preview",
    modalities=["image", "text"],
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Repaint the car blue and remove the background"},
            {"type": "image_url", "image_url": {"url": "data:image/png;base64,<YOUR-PHOTO>"}},
        ],
    }],
)
bash
curl https://nordrouter.com/v1/images/generations \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "Coffee shop logo, minimalist, emerald on white",
    "size": "1024x1024",
    "n": 1
  }'
python
resp = client.images.generate(
    model="openai/gpt-image-2",
    prompt="Coffee shop logo, minimalist, emerald on white",
    size="1024x1024",
)
img_b64 = resp.data[0].b64_json

Documentación oficial y enlaces

Model≈ per imageHow to call
google/gemini-3.1-flash-image-preview (Nano Banana)~$0.012chat + modalities
google/gemini-3-pro-image (Nano Banana Pro)~$0.028chat + modalities
openai/gpt-image-2~$0.001–0.10 (varies by size & quality)/v1/images/generations
Size · qualityOutput tokensPrice
1024×1024 · low~200~$0.0014
1024×1024 · high~7,000~$0.05
1536×1024 · high~10,500~$0.076
2048×2048 · high~14,300~$0.10

Guías relacionadas

Comprueba primero la conexión con una solicitud de texto mínima. Después añade streaming, herramientas, imágenes u otras funciones avanzadas. Nunca incluyas la clave API en código público ni en un frontend del navegador.

Solución de problemas