Google/gemini-3-pro-image

谷歌最强大的图像生成模型

OperativoTexto a imagenImagen a imagen-50%vs. oficialPrecio por dimensiones de usoUso comercialPrivacidad de datos

Entradaesquema real

参考图 URLreference_image_urls
No test requests yet. Send your first request.

Salida

Ejecuta el formulario de la izquierda. Los resultados, el estado del sondeo y el cURL aparecen debajo.

Precios

Este modelo se cobra según las dimensiones de uso indicadas aquí. Comparar todos los precios.

Precios de lista en USD. Tu precio efectivo también depende del grupo de facturación de tu clave API.

Criterioprompt_tokensgemini-3-pro-image
$1.00por 1 M2/1M
Criteriocompletion_tokensgemini-3-pro-image
$60.00por 1 M120/1M
Criteriothoughts_tokensgemini-3-pro-image
$6.00por 1 M12/1M

API

POST/v1beta/models/gemini-3-pro-image:generateContent
const BASE_URL = "https://api.dreamtoai.com";
const API_KEY = process.env.MIX_API_KEY;

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

const payload = {
  "model": "gemini-3-pro-image",
  "input": {
    "prompt": "修复键盘顶端斑驳痕迹,其他内容不变",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "image_size": "1K",
    "aspect_ratio": "1:1",
    "mime_type": "image/png",
    "response_modalities": [
      "TEXT",
      "IMAGE"
    ],
    "seed": 12345,
    "callback_url": "https://example.com/webhook"
  }
};

const submit = await fetch(`${BASE_URL}/v1/jobs`, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
}).then((r) => r.json());

const status = await fetch(`${BASE_URL}/v1/jobs/${submit.id}`, { headers })
  .then((r) => r.json());
console.log(status);

Crea una clave en Consola → Claves API y reemplaza el marcador del ejemplo.

README

gemini-3-pro-image

谷歌最强大的图像生成模型

¿Por qué elegirlo?

Generación de texto a imagen
Convierte prompts en lenguaje natural en imágenes terminadas.
Pago por token
$1.00 por 1M de tokens de entrada y $60.00 por 1M de tokens de salida, sin suscripción.
Compatible con tu SDK actual
Llámalo en formato Gemini: los clientes existentes solo necesitan una nueva URL base y una clave.
Una clave para todos los modelos
La misma clave de API sirve para todos los modelos de dreamtoai.

Parámetros

ParámetroObligatorioDescripción
promptstringObligatorioDescripción en texto de lo que se quiere generar.
reference_image_urlsarrayOpcionalImágenes de referencia para guiar el resultado.
image_sizestringOpcionalTamaño de la imagen de salida. Predeterminado: 1K.
aspect_ratiostringOpcionalRelación de aspecto de la salida.
mime_typeenumOpcional参考图 MIME Opciones: image/png, image/jpeg, image/webp. Predeterminado: image/png.
response_modalitiesarrayOpcional响应模态
seedintegerOpcionalSemilla aleatoria. Reutilízala para reproducir un resultado.
callback_urlstringOpcional回调地址

Cómo usarlo

  1. Pruébalo aquí primero — Inicia sesión y ejecuta el modelo en el playground de arriba para revisar el resultado antes de escribir código.
  2. Crea una clave de API — Abre Consola → Claves de API y crea una clave. La misma clave sirve para todos los modelos.
  3. Escribe tu prompt — Describe el sujeto, el estilo, la composición y la iluminación que quieres.
  4. Configura los parámetros opcionales — Ajusta los parámetros opcionales de arriba para controlar la salida.
  5. Envía la solicitud — Llama a POST /v1beta/models/gemini-3-pro-image:generateContent con el ID de modelo gemini-3-pro-image.
  6. Lee el resultado — El resultado generado llega en la respuesta y la solicitud queda registrada en la consola.

Cómo escribir prompts eficaces

El modelo lee un prompt como un brief creativo. Nombra primero el sujeto y luego añade los detalles que importan.

1. Sujeto y acción

Quién o qué aparece en la imagen y qué está haciendo.

2. Estilo y técnica

Foto, render 3D, acuarela o ilustración plana. Para un aspecto fotográfico, indica un objetivo o un tipo de película.

3. Composición

Encuadre y punto de vista: primer plano, plano general, cenital, centrado, regla de los tercios.

4. Iluminación y color

Hora dorada, luz de estudio suave, neón, paleta pastel, alto contraste.

5. Texto en la imagen

Pon las palabras exactas entre comillas y di dónde van.

Un póster con el titular "OPEN LATE" en letras blancas gruesas en la parte superior.
Prompt
Débiluna cafetería
SólidoUna acogedora cafetería de esquina en una tarde lluviosa, vista a través del escaparate. Luz cálida de tungsteno dentro, un barista vertiendo arte latte, condensación en el cristal, reflejos de la calle. Foto de 35 mm, poca profundidad de campo, paleta apagada de verde azulado y ámbar.

Precios

Concepto facturadoPrecioPrecio oficial
prompt_tokens$1.00 por 1 M$2.00/1M
completion_tokens$60.00 por 1 M$120.00/1M
thoughts_tokens$6.00 por 1 M$12.00/1M

Es un 50% menos que el precio oficial de lista.

Ejemplo: una solicitud con 10.000 tokens de entrada y 1.000 de salida cuesta unos $0.07.

Precios de lista en USD. Tu precio efectivo también depende del grupo de facturación de tu clave API. Comparar todos los precios

Mejores casos de uso

  • Marketing y publicidad — Crea visuales de campaña y variaciones de anuncios en minutos.
  • Comercio electrónico — Crea fotos de producto, escenas de estilo de vida y banners.
  • Arte conceptual y storyboards — Explora personajes, entornos y escenas antes de la producción.
  • Contenido para redes sociales — Crea imágenes acordes a la marca en formato cuadrado, vertical u horizontal.
  • Exploración de diseño — Prueba maquetaciones, paletas y estilos rápidamente.
  • Ilustración editorial — Ilustra artículos, boletines y presentaciones.

Consejos avanzados

  • Genera varias variantes de un prompt prometedor antes de pulir los detalles.
  • Pon el sujeto en la primera frase; añade estilo e iluminación después.
  • Escribe entre comillas cualquier texto que deba aparecer en la imagen.
  • Elige la relación de aspecto según dónde se usará la imagen antes de generarla.
  • Si el modelo admite semilla, reutiliza la misma para comparar cambios de prompt de forma justa.

Ver todos los modelos de imagenExplorar API Market

FAQ

¿Qué es gemini-3-pro-image?

谷歌最强大的图像生成模型

¿Cómo llamo a la API de gemini-3-pro-image?

Envía POST /v1beta/models/gemini-3-pro-image:generateContent con el ID de modelo gemini-3-pro-image y tu clave de API. En la sección API de arriba hay ejemplos listos para ejecutar.

¿Cómo se calcula la facturación?

Las solicitudes se facturan a los precios indicados arriba y se cargan a tu cartera. El coste final depende del uso y del grupo de facturación asociado a tu clave API.

¿Dónde consigo una clave API?

Créala en Consola → Claves API. La misma clave sirve para todos los modelos del gateway.

¿Puedo usar el resultado con fines comerciales?

Sí. Puedes usar lo que generes en proyectos comerciales, sujeto a los términos del proveedor del modelo.

Acerca de gemini-3-pro-image en dreamtoai

谷歌最强大的图像生成模型

Modelos relacionados

Próximos pasos