GPT Image 1 API
Generate images with GPT Image 1 through the APINEED asynchronous media API.
Submit a task, save its ID, and poll the task endpoint for its status and result URLs.
Playground
Generate with GPT Image 1, review the output, and use the same request shape in your application.
Request preview
{
"model": "gpt-image-1",
"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 and live API pricing.
Pricing
Pricing uses the current live API Need configuration for this model.
Availability
Recent public performance data for this model.
Gallery
Quick Start
Call GPT Image 1 with the verified APINEED endpoint and model-specific request shape.
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 gpt-image-1 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": "gpt-image-1",
"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);GPT Image 1 API Endpoint
Create an asynchronous image task, then use its task ID to retrieve status and direct object-storage output URLs.
/v1/media/generations- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- gpt-image-1
/v1/media/generations/{id}- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- gpt-image-1
Parameters
These controls follow APINEED's current DTO and adapter behavior. Unsupported upstream-only fields are intentionally omitted.
| Name | Type | Values | Description |
|---|---|---|---|
model | string | Required | Use gpt-image-1. |
workflow | string | 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. |
output.count | integer | 1–10 | Published by the backend capability contract. |
GPT Image 1 API questions
Practical answers for choosing, integrating, pricing, and operating the GPT Image 1 API on APINEED.
How to deploy GPT Image 1
Connect GPT Image 1 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 gpt-image-1 requests to /v1/media/generations.
Track the task
Poll the returned task ID and store the completed image URL from outputs[].
