Generate or edit images (workspace-scoped)

Generate or edit images via the Vercel AI Gateway. Supports text-to-image and image-to-image editing. Billed per image under ai:image. Pass x-blink-agent-id for per-agent usage.

post/api/v1/ai/image

Request

Base URL
https://core.blink.new
URL
https://core.blink.new/api/v1/ai/image
Auth
- HTTP bearer
- or HTTP bearer

Request body

Image generation model routed through the Vercel AI Gateway. Omit it to use the current default; requests carrying reference images default to a multimodal editing model instead, since image-only models cannot edit. Supports Gateway canonical IDs (openai/gpt-image-2, google/gemini-2.5-flash-image, google/gemini-3-pro-image, bfl/flux-pro-1.1, bytedance/seedream-4.5, recraft/recraft-v3, …). Legacy fal-ai/* and bare gemini IDs are transparently rewritten for backwards compatibility.

promptstring required

Text description of the desired image. Supports up to 100,000 characters for detailed descriptions.

imagesstring[]

Input images for editing (optional). Supports up to 50 images with automatic format conversion for compatibility.

maskstring

🚫 NOT SUPPORTED: Mask editing has been deprecated. This API exclusively uses Gemini 2.5 Flash Image which provides superior editing without requiring masks.

size'auto'

📝 INFORMATIONAL ONLY: Gemini automatically optimizes image dimensions. This parameter is accepted but ignored.

quality'auto' | 'high' | 'medium' | 'low'

📝 INFORMATIONAL ONLY: Gemini automatically optimizes quality. This parameter is accepted but ignored.

background'auto' | 'transparent' | 'opaque'

📝 INFORMATIONAL ONLY: Gemini handles backgrounds automatically. This parameter is accepted but ignored.

style'vivid' | 'natural'

📝 INFORMATIONAL ONLY: Gemini uses its own style optimization. This parameter is accepted but ignored.

ninteger

Number of images to generate

response_format'url'

📝 INFORMATIONAL ONLY: Always returns cloud storage URLs. This parameter is ignored for consistency.

output_format'png' | 'jpeg' | 'webp'

✅ FUNCTIONAL: Controls final cloud storage format. WebP recommended for best compression.

output_compressioninteger

✅ FUNCTIONAL: Controls compression level during cloud storage conversion (0-100%). Higher = better quality, larger files.

moderation'auto'

📝 INFORMATIONAL ONLY: Gemini has built-in safety filters. This parameter is accepted but ignored.

Example request

{
  "prompt": "A futuristic cityscape at sunset with flying cars and neon lights, rendered in a cyberpunk art style with vibrant colors",
  "images": [
    "https://example.com/input-image.jpg",
    "data:image/heic;base64,/9j/4AAQ..."
  ],
  "mask": "https://example.com/mask-image.png"
}

Response

Image(s) generated successfully

Example response

{
  "result": {
    "data": [
      {
        "url": "https://cdn.blink.new/projects/my-project-123/images/generated-image-1750914281902-0.webp",
        "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
        "revised_prompt": "A futuristic cityscape at sunset with flying cars and neon lights, digital art style"
      }
    ],
    "created": 1713833628,
    "background": "transparent",
    "output_format": "webp",
    "size": "1024x1024",
    "quality": "hd",
    "usage": {
      "total_tokens": 100,
      "input_tokens": 50,
      "output_tokens": 50,
      "input_tokens_details": {
        "text_tokens": 10,
        "image_tokens": 40
      }
    }
  },
  "metadata": {
    "provider": "google-gemini"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.