GPT Image API
Text-to-image and image editing powered by OpenAI's image generation models.
curl -X POST https://runapi.ai/api/v1/gpt_image/text_to_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-1.5",
"prompt": "Generate a flat-design illustration of a team collaborating around a whiteboard, vibrant colors, clean lines."
}'
import { GptImageClient } from "@runapi.ai/gpt-image";
const client = new GptImageClient();
const result = await client.textToImage.run({
model: "gpt-image-1.5",
prompt: "Generate a flat-design illustration of a team collaborating around a whiteboard, vibrant colors, clean lines.",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\GptImage\GptImageClient;
$client = new GptImageClient();
$result = $client->textToImage->run([
'model' => 'gpt-image-1.5',
'prompt' => 'Generate a flat-design illustration of a team collaborating around a whiteboard, vibrant colors, clean lines.',
]);
require "runapi/gpt_image"
client = RunApi::GptImage::Client.new
result = client.text_to_image.run(
model: "gpt-image-1.5",
prompt: "Generate a flat-design illustration of a team collaborating around a whiteboard, vibrant colors, clean lines."
)
npx skills add runapi-ai/gpt-image -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
GPT Image is OpenAI's image generation model supporting both text-to-image and image editing creation with strong compositional control. It produces high-quality visuals across photorealistic and stylized outputs.
- عدة إصدارات لمستويات مختلفة من السرعة / الجودة
- يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
- يعمل مع workflows موجهة لتطوير التطبيقات
- لا يتم احتساب رسوم على عمليات التوليد الفاشلة
التسعير
التفاصيل الفنية
| معرّف النموذج | gpt-image-1.5 |
| المزوّد | OpenAI |
| الوسيط | image |
| نوع المهمة | asynchronous |
| وحدة الفوترة | call |
| API endpoint | /api/v1/gpt_image/text_to_image |
| ترخيص تجاري | نعم — مشمول عبر API |
| حالة الكتالوج | جاهز للتشغيل |
ثبّت skill GPT Image لتطوير التطبيقات
حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.
# Install the model skill for app development workflows
npx skills add runapi-ai/gpt-image -g
Install the GPT Image skill for this app: 1. Add runapi-ai/gpt-image with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
من model skill إلى أول نتيجة في أربع خطوات
اختر النموذج
اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.
الإعداد
اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.
التنفيذ
استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.
الاستلام
استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.
ما هي GPT Image API؟
GPT Image is OpenAI's image generation model, supporting text-to-image and image editing. Through RunAPI, all GPT Image endpoints share one key and per-call pricing.
لماذا تستخدم GPT Image API عبر RunAPI
مصادقة واحدة لكل مزود
مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.
تسعير وفوترة موحّدان
تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.
Skill مع schemas
تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.
أسئلة شائعة
What endpoints does GPT Image support?
توليد الصور من النص وتحرير الصور. كلاهما يقبل مطالبات نصية مفصّلة مع تعليمات تركيبية.
How does compositional control work?
GPT Image follows spatial layout instructions in your prompt — you can specify where objects appear, relative sizes, and arrangement within the frame.
What output sizes are available?
3 fixed sizes up to 1536 pixels. The text-to-image endpoint also supports transparent PNG output.
How does GPT Image compare to GPT Image 2?
GPT Image 2 is the newer model with near-perfect multilingual text rendering and up to 4K output. GPT Image is the prior generation with strong compositional control.
Can I use GPT Image for editing?
Yes — the image editing endpoint accepts a source image and modifies it based on your text prompt, acting as an image editing tool.
أي نسخة ينبغي أن أبدأ بها؟
اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.
هل توجد خطة مجانية؟
تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.
هل تدعمون البث المباشر للنتائج؟
حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.
كيف يتم احتساب الرسوم عند الفشل؟
لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.
هل يتم تخزين المخرجات مؤقتًا؟
يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.
هل يمكنني الاستخدام تجاريًا؟
نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.
ماذا عن حدود المعدل؟
تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.
أين يمكنني الإبلاغ عن المشاكل؟
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.
إذا أعجبتك GPT Image API، فجرّب هذه الخيارات
ابدأ البناء باستخدام GPT Image API.
- edit_image
- text_to_image