API Need
Ggemini-3-pro-image-preview API
gemini-3-pro-image-preview
Generate images with gemini-3-pro-image-preview through the APINEED asynchronous media API.
Submit a task, save its ID, and poll the task endpoint for its status and result URLs.
MODALITIES
Playground
Generate with gemini-3-pro-image-preview, review the output, and use the same request shape in your application.
No supported image request format is published for this model yet.
Output Ready
Request preview
{
"model": "gemini-3-pro-image-preview",
"workflow": "text_to_image",
"input": {
"prompt": "A refined product photograph with natural lighting, realistic materials and a clean background."
},
"output": {
"count": 1
}
}Provider
Current API Need routing.
Pricing
Current selling prices in USD. Channel and group adjustments are already included. A range means available routes have different prices.
Image output$78 – $125.97 / 1M image tokens
Input$1.3 – $2.0995 / 1M
Text output$7.8 – $12.597 / 1M
Cache read$0.13 – $0.20995 / 1M
Cache write$1.54375 – $2.49315625 / 1M
Web search$9.1 – $14.6965 per thousand queries
Availability
Recent public performance data for this model.
No model-specific availability history is published yet. A successful request is not an uptime guarantee.
Gallery
Quick Start
Call gemini-3-pro-image-preview with the endpoint and request format shown below.
Create an API key
Store your APINEED key server-side as API_NEED_API_KEY.
export API_NEED_API_KEY=sk-apineed-v1-...Send the request
Use gemini-3-pro-image-preview with POST /v1/media/generations.
curl https://apineed.com/v1/media/generations \
-H "Authorization: Bearer $API_NEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-preview",
"workflow": "text_to_image",
"input": {
"prompt": "A refined product photograph with natural lighting, realistic materials and a clean background."
},
"output": {
"count": 1
}
}'Poll the task
Save id, then poll GET /v1/media/generations/{id} every few seconds until the task is succeeded or failed.
curl https://apineed.com/v1/media/generations/$TASK_ID -H "Authorization: Bearer $API_NEED_API_KEY"const images = task.outputs.filter((item) => item.type === "image").map((item) => item.url);gemini-3-pro-image-preview API Endpoint
Create an asynchronous image task, then use its task ID to retrieve status and direct object-storage output URLs.
POST
/v1/media/generations- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- gemini-3-pro-image-preview
GET
/v1/media/generations/{id}- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- gemini-3-pro-image-preview
Parameters
Use the supported parameters below. Leave optional fields out to use the service defaults.
| Name | Type | Values | Description |
|---|---|---|---|
model | string | Required | Use gemini-3-pro-image-preview. |
workflow | string | text_generation, text_to_image, image_edit | Use an APINEED-supported workflow. |
input.prompt | string | Required | Describe the requested image. |
input.assets | array | Required for image_edit | Image URLs with role input_image; up to 1 references. |
gemini-3-pro-image-preview API questions
Practical answers for choosing, integrating, pricing, and operating the gemini-3-pro-image-preview API on APINEED.
Which model ID should I use for gemini-3-pro-image-preview?
Use gemini-3-pro-image-preview, exactly as returned by the API Need pricing API.
Which endpoint should I use?
Send a POST request to /v1/media/generations using your APINEED API key. Save the returned task ID, then poll GET /v1/media/generations/{id} until the task succeeds or fails. Follow the request example and parameter table on this page.
How is the API Need price calculated?
See Pricing for the current rates and discounts. Final charges use recorded usage.
How to deploy gemini-3-pro-image-preview
Connect gemini-3-pro-image-preview to your application through the APINEED media API.
Add credits
Add APINEED credits before submitting a billable generation.
Create an API key
Create and securely store an APINEED API key.
Configure the endpoint
Send gemini-3-pro-image-preview requests to /v1/media/generations.
Track the task
Poll the returned task ID and store the completed image URL from outputs[].