
Openai GPT Image 1 Edit API by OpenAI
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.
Girdi
Çıktı
BoştaHer çalıştırma $0.009 maliyete sahip. 10$ ile yaklaşık 1111 kez çalıştırabilirsiniz.
Şununla devam edebilirsiniz:
Kod örneği
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()Kurulum
Programlama diliniz için gerekli paketi kurun.
pip install requestsKimlik Doğrulama
Tüm API istekleri, API anahtarı ile kimlik doğrulama gerektirir. API anahtarınızı Atlas Cloud kontrol panelinden alabilirsiniz.
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP Başlıkları
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}API anahtarınızı asla istemci tarafı kodunda veya herkese açık depolarda ifşa etmeyin. Bunun yerine ortam değişkenleri veya arka uç proxy kullanın.
İstek gönder
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())İstek Gönder
Asenkron bir oluşturma isteği gönderin. API, durumu kontrol etmek ve sonucu almak için kullanabileceğiniz bir tahmin ID'si döndürür.
/api/v1/model/generateImageİstek Gövdesi
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']}")Yanıt
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}Durumu Kontrol Et
İsteğinizin mevcut durumunu kontrol etmek için tahmin uç noktasını sorgulayın.
/api/v1/model/prediction/{prediction_id}Sorgulama Örneği
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)Durum Değerleri
processingİstek hâlâ işleniyor.completedOluşturma tamamlandı. Çıktılar kullanılabilir.succeededOluşturma başarılı oldu. Çıktılar kullanılabilir.failedOluşturma başarısız oldu. Hata alanını kontrol edin.Tamamlanmış Yanıt
{
"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"
}
}Dosya Yükle
Dosyaları Atlas Cloud depolama alanına yükleyin ve API isteklerinizde kullanabileceğiniz bir URL alın. Yüklemek için multipart/form-data kullanın.
/api/v1/model/uploadMediaYükleme Örneği
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}")Yanıt
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Input Schema
İstek gövdesinde aşağıdaki parametreler kabul edilir.
Kullanılabilir parametre yok.
Örnek İstek Gövdesi
{
"model": "openai/gpt-image-1/edit"
}Output Schema
API, oluşturulan çıktı URL'lerini içeren bir tahmin yanıtı döndürür.
Örnek Yanıt
{
"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'den fazla AI modelini doğrudan AI kodlama asistanınıza entegre eder. Kurmak için tek bir komut, ardından görüntü, video oluşturmak ve LLM ile sohbet etmek için doğal dil kullanın.
Desteklenen İstemciler
Kurulum
npx skills add AtlasCloudAI/atlas-cloud-skillsAPI Anahtarını Ayarla
API anahtarınızı Atlas Cloud kontrol panelinden alın ve ortam değişkeni olarak ayarlayın.
export ATLASCLOUD_API_KEY="your-api-key-here"Yetenekler
Kurulduktan sonra, tüm Atlas Cloud modellerine erişmek için AI asistanınızda doğal dil kullanabilirsiniz.
MCP Server
Atlas Cloud MCP Server, IDE'nizi Model Context Protocol aracılığıyla 300'den fazla AI modeline bağlar. Herhangi bir MCP uyumlu istemci ile çalışır.
Desteklenen İstemciler
Kurulum
npx -y atlascloud-mcpYapılandırma
Aşağıdaki yapılandırmayı IDE'nizin MCP ayarları dosyasına ekleyin.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}Mevcut Araçlar
API Şeması
Şema mevcut değilÖrnek mevcut değil
İstek geçmişini görüntülemek için oturum açın
Model istek geçmişinize erişmek için oturum açmanız gerekir.
Oturum Aç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.






