Google Gemini 3 Pro Image Text To Image API Documentation

Google Gemini 3 Pro Image Text To Image API Documentation

Playground

Google’s Gemini 3.0 Pro (Gemini 3.0 Pro Preview) is a cutting-edge text-to-image model enabling high-res 4K image generation optimized for phones. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Gemini 3.0 Pro Image (Gemini 3.0 Pro Image Preview) is Google’s lightweight yet powerful AI image generation model, built for creators who need fast, high-quality visuals from simple text prompts. It transforms words into expressive, realistic images with remarkable clarity, composition, and style diversity — all within seconds.

🌟 Why it stands out

• Instant Image Creation Generate beautiful, coherent visuals from just a short text prompt — no design skills required.

• Versatile Visual Styles Supports realistic, illustrative, anime, and painterly outputs, adapting naturally to your creative intent.

• Accurate Text-to-Scene Understanding Accurately interprets subjects, backgrounds, and object relationships to create contextually correct compositions.

• Fast & Efficient Optimized for quick turnaround and minimal compute cost, perfect for rapid prototyping and social content.

• Clean, Balanced Lighting Produces visually appealing results without overexposure or unnatural shadows — ideal for portraits, landscapes, and product imagery.

⚙️ Capabilities

• Input: text prompt

• Output: high-quality image (JPEG/PNG)

• Supports multiple aspect ratios and output format

• Compatible with descriptive prompts such as:

• “A golden retriever playing in a field of sunflowers at sunset.”

• “A futuristic city skyline with neon reflections on wet streets.”

• “An elegant still-life photo of coffee and croissants by a window.”

💰 Pricing

💡 Best Use Cases

• Social Media & Marketing — Create on-brand visuals instantly.
• Concept Art & Storyboarding — Generate design ideas and moodboards effortlessly.
• E-commerce & Advertising — Produce high-quality product images without photography.
• Education & Presentation — Visualize complex ideas or creative concepts easily.

📝 Notes

Please ensure your prompts comply with Google’s Safety Guidelines. If an error occurs, review your prompt for restricted content, adjust it, and try again.

🌏 Where gemini-3-pro-image Fits In

Compare gemini-3-pro-image T2I with:

• FLUX.1 [dev] – Nano Banana Pro Edit focuses on semantic understanding and layout-aware editing via Gemini 3’s reasoning, making it ideal for complex, text-driven transformations without manual masking. FLUX.1 [dev] emphasizes maximum resolution control and fine detail preservation for highly technical workflows.

• Stable Diffusion 3.5 – Nano Banana Pro Edit leverages Google’s production-scale multimodal training and advanced reasoning for context-aware edits that understand object relationships and composition. Stable Diffusion 3.5 offers open-source flexibility for custom fine-tuning and local deployment in highly specialized pipelines.

• Gpt-Image-1 (OpenAI) – Nano Banana Pro Edit emphasizes layout control, multilingual on-image text, and tightly directed edits for design and marketing workflows, while openai/gpt-image-1 shines as a general-purpose creative generator with strong style variety and fast, natural-language image synthesis for broad consumer and developer use.

• Original Nano Banana (Gemini 2.5 Flash Image) – Nano Banana Pro Edit trades pure speed for quality, delivering better reasoning, sharper text, improved character consistency, and richer camera controls at a higher unit cost. Original Nano Banana remains ideal for rapid, low-latency iterations and lightweight edits.

• Seedream – Nano Banana Pro Edit is tuned for reliable typography, photo-real edits, and mixed media layouts, while SeeDream excels at fast, stylized T2I generation with strong anime and illustration aesthetics, making it a good choice for heavily stylized concept art.

• Qwen Image 2509 – Nano Banana Pro Edit focuses on high-fidelity 4K outputs and multilingual on-image design control, whereas Qwen Image shines in open-source ecosystems and document-style rendering, offering flexible integration for developer-centric and research workflows.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "1:1",
  "resolution": "1k",
  "output_format": "png"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/google/gemini-3-pro-image/text-to-image" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters