Openai GPT Image 1 Edit API by OpenAI
openai/gpt-image-1/edit
Edit
OpenAI's gpt-image-1 enables image generation and image editing via OpenAI's image API, ideal for creating and refining images. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
代码示例
import requests
import time
# Step 1: Start image generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "openai/gpt-image-1/edit",
"prompt": "A beautiful landscape with mountains and lake",
"width": 512,
"height": 512,
"steps": 20,
"guidance_scale": 7.5,
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] == "completed":
print("Generated image:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
image_url = check_status()安装
安装所需的依赖包。
bash
pip install requests认证
所有 API 请求需要通过 API Key 进行认证。您可以在 Atlas Cloud 控制台获取 API Key。
bash
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP 请求头
python
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}保护好您的 API Key
切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。
提交请求
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())提交请求
提交一个异步生成请求。API 返回一个 prediction ID，您可以用它来检查状态和获取结果。
POST
/api/v1/model/generateImage请求体
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "openai/gpt-image-1/edit",
"input": {
"prompt": "A beautiful landscape with mountains and lake"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")响应
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}检查状态
轮询 prediction 端点以检查请求的当前状态。
GET
/api/v1/model/prediction/{prediction_id}轮询示例
import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)状态值
processing请求仍在处理中。completed生成完成，输出可用。succeeded生成成功，输出可用。failed生成失败，请检查 error 字段。完成响应
{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}上传文件
将文件上传到 Atlas Cloud 存储，获取可在 API 请求中使用的 URL。使用 multipart/form-data 上传。
POST
/api/v1/model/uploadMedia上传示例
import requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")响应
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Input Schema
以下参数在请求体中被接受。
总计: 0必填: 0可选: 0
暂无可用参数。
请求体示例
json
{
"model": "openai/gpt-image-1/edit"
}Output Schema
API 返回包含生成输出 URL 的 prediction 响应。
idstringrequired
Unique identifier for the prediction.
statusstringrequired
Current status of the prediction.
processingcompletedsucceededfailed
modelstringrequired
The model used for generation.
outputsarray[string]
Array of output URLs. Available when status is "completed".
errorstring
Error message if status is "failed".
metricsobject
Performance metrics.
predict_timenumber
Time taken for image generation in seconds.
created_atstringrequired
ISO 8601 timestamp when the prediction was created.
completed_atstring
ISO 8601 timestamp when the prediction was completed.
响应示例
json
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills
Atlas Cloud Skills 将 300+ AI 模型直接集成到您的 AI 编程助手中。一条命令安装，即可用自然语言生成图像、视频和与 LLM 对话。
支持的客户端
Claude Code
OpenAI Codex
Gemini CLI
Cursor
Windsurf
VS Code
Trae
GitHub Copilot
Cline
Roo Code
Amp
Goose
Replit
40+ 支持的客户端
安装
bash
npx skills add AtlasCloudAI/atlas-cloud-skills设置 API Key
从 Atlas Cloud 控制台获取 API Key，并将其设置为环境变量。
bash
export ATLASCLOUD_API_KEY="your-api-key-here"功能
安装后，您可以在 AI 助手中使用自然语言访问所有 Atlas Cloud 模型。
图像生成使用 Nano Banana 2、Z-Image 等模型生成图像。
视频创作使用 Kling、Vidu、Veo 等模型从文本或图像创建视频。
LLM 对话与 Qwen、DeepSeek 等大语言模型对话。
媒体上传上传本地文件用于图像编辑和图生视频工作流。
MCP Server
Atlas Cloud MCP Server 通过 Model Context Protocol 将您的 IDE 与 300+ AI 模型连接。支持任何兼容 MCP 的客户端。
支持的客户端
Cursor
VS Code
Windsurf
Claude Code
OpenAI Codex
Gemini CLI
Cline
Roo Code
100+ 支持的客户端
安装
bash
npx -y atlascloud-mcp配置
将以下配置添加到您的 IDE 的 MCP 设置文件中。
json
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}可用工具
atlas_generate_image从文本提示生成图像。
atlas_generate_video从文本或图像创建视频。
atlas_chat与大语言模型对话。
atlas_list_models浏览 300+ 可用 AI 模型。
atlas_quick_generate一步式内容创建，自动选择最佳模型。
atlas_upload_media上传本地文件用于 API 工作流。
API Schema
Schema 不可用暂无可用示例
OpenAI GPT-Image-1-Edit
Edit and transform images with natural language using OpenAI's GPT-Image-1-Edit. This versatile model understands your instructions to apply style changes, modifications, and creative transformations — with optional mask support for precise regional editing and multiple quality tiers to match your needs and budget.
Why It Looks Great
- Natural language editing: Describe transformations in plain text — style changes, modifications, enhancements.
- Mask support: Use mask images for precise control over which areas to edit.
- Quality tiers: Choose from
low,medium, orhighquality based on your needs. - Multiple sizes: Output in square (
1024x1024) or rectangular (1024x1536,1536x1024) formats. - Style transformation: Excels at converting images to different artistic styles.
- OpenAI quality: Powered by advanced vision-language understanding.
Parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Text instruction describing the edit or transformation you want. |
image | Yes | Source image to edit (upload or public URL). |
quality | No | Output quality: low, medium, or high. Default: medium. |
mask_image | No | Optional mask to specify edit regions (upload or URL). |
size | No | Output dimensions: 1024x1024, 1024x1536, or 1536x1024. |
enable_sync_mode | No | API only: Waits for result and returns it directly. |
enable_base64_output | No | API only: Returns base64 string instead of URL. |
How to Use
- Write your edit instruction — describe the transformation you want (e.g.
"Become a comic style"). - Upload your image — drag and drop or paste a public URL.
- Choose quality — select
low,medium, orhighbased on your needs. - Add mask (optional) — upload a mask image to limit edits to specific areas.
- Select size — choose your desired output dimensions.
- Run — click the button to apply the edit.
- Download — preview and save your transformed image.
Quick Reference
| Quality | 1024x1024 | 1024x1536 / 1536x1024 |
|---|---|---|
| Low | $0.011 | $0.016 |
| Medium | $0.042 | $0.063 |
| High | $0.167 | $0.250 |
Best Use Cases
- Style Transfer — Convert photos to comic, cartoon, painting, or other artistic styles.
- Creative Transformation — Reimagine images with different aesthetics or themes.
- Regional Editing — Use masks to edit specific areas while preserving the rest.
- Content Enhancement — Improve or modify specific aspects of images.
- Artistic Interpretation — Transform photos into various art forms.
Example Prompts
"Become a comic style"
"Transform into a watercolor painting"
"Make it look like a vintage photograph from the 1950s"
"Convert to anime style illustration"
"Apply a cyberpunk neon aesthetic"
"Turn into a pencil sketch"
Quality Guide
| Quality | Best For | Trade-off |
|---|---|---|
| Low | Quick previews, testing concepts, high-volume processing | Fastest, most affordable, lower detail |
| Medium | General use, social media, balanced needs | Good quality/cost balance |
| High | Professional work, final deliverables, maximum detail | Highest quality, premium price |
Pro Tips for Best Results
- Start with
mediumquality to test your prompt, then upgrade tohighfor final output. - Use masks when you want to preserve specific areas untouched.
- Be specific about the target style —
"comic style","oil painting","anime". - For style transfers, simpler source images often produce cleaner results.
- Rectangular sizes work well for portraits (
1024x1536) or landscapes (1536x1024). - The model interprets style instructions creatively — embrace the artistic interpretation.
Notes
- If using URLs for images or masks, ensure they are publicly accessible.
- The
enable_sync_modeandenable_base64_outputoptions are only available through the API. - Mask images should be black and white, where white indicates areas to edit.
- Processing time varies by quality level — higher quality takes longer.
