Image APIs

This section documents the public image-generation interfaces exposed by ReachAPI.

The image APIs in this group currently expose three interface styles:

Use POST /v1/images/create for the seedream-4-5, seedream-5-0-lite, seedream-5-0-pro, nanobanana, nanobanana-2, and nanobanana-pro task-based image APIs
Use POST /v1/images/create with model: "gpt-image-2-async" for the GPT Image 2 async task API
Use the separate OpenAI-compatible Image API with model: "gpt-image-2" for /v1/images/generations and /v1/images/edits
Poll task status with GET /v1/tasks/{task_id} for the task-based image APIs
Optionally receive the final result through callback_url
Read generated files from data[].url after the task reaches success

Available references:

OpenAI Image API: OpenAI-compatible image generation and editing interface for gpt-image-2
GPT Image 2 Async Image API: task-based image generation and editing with gpt-image-2-async
Seedream: text-to-image, image editing, and sequential image generation with URL-only image input
nanobanana: text-to-image and lightweight image editing, up to 5 reference images, no resolution, no web search
nanobanana-2: image generation, image editing, and search-enhanced generation with broader aspect ratio and resolution options
nanobanana-pro: higher-tier image generation and editing with large-output resolution options

Capability Matrix

Model ID	Typical use	Max reference images	`resolution`	`enable_web_search`	Notable constraints
`nanobanana`	text-to-image, image editing	5	Not supported	Not supported	Best with fewer reference images
`gpt-image-2-async`	text-to-image, image editing	14	`1k`, `2k`, `4k`	Not supported	Async task API for GPT Image 2
`seedream-4-5` / `seedream-5-0-lite`	text-to-image, image editing, sequential generation	14	`2k`, `3k`, `4k` by model	Not supported	URL-only image input; no `aspect_ratio`
`seedream-5-0-pro`	text-to-image, multi-reference generation, interactive editing	10	`1k`, `2k`	Not supported	Freeform and coordinate-based editing; URL-only image input
`nanobanana-2`	text-to-image, image editing, real-time context generation	14	`0.5k`, `1k`, `2k`, `4k`	Supported	Supports extra wide and tall aspect ratios
`nanobanana-pro`	premium image generation, high-quality editing	14	`1k`, `2k`, `4k`	Supported	Focused on higher-quality output choices

Base URL: https://direct.reachapi.ai
Authentication: use your ReachAPI key in Authorization: Bearer YOUR_REACH_API_KEY
Content type: application/json
Task result contract: the final image URLs are returned in data[].url
Shared platform conventions: /docs/api-reference/reference-overview
Local file upload: /docs/api-reference/file/upload