الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
images
/
generations
Create images
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dall-e-3",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1773311889,
  "data": [
    {
      "revised_prompt": "A paper boat floating on calm water at sunrise, with soft golden light reflecting off the water's surface.",
      "url": "https://filesystem.site/cdn/20260312/1d6826050921c07a13ff173310c640.webp"
    }
  ]
}
استخدم هذا المسار لإنشاء صور من النص باستخدام صيغ طلبات متوافقة مع OpenAI على CometAPI.

​
اختر model أولاً

  • استخدم dall-e-3 عندما تريد اختبارًا بسيطًا يعتمد على URL
  • استخدم gpt-image-1 أو gpt-image-1-mini أو gpt-image-1.5 عندما تريد نماذج صور GPT الأحدث ويمكنك التعامل مع استجابات base64
  • استخدم qwen-image عندما تحتاج إلى هذا المزوّد تحديدًا، لكن أبقِ n عند 1

​
أول طلب آمن

  • ابدأ بـ dall-e-3
  • أبقِ size عند 1024x1024
  • عيّن response_format: "url" إذا كنت تريد استجابة JSON صغيرة وURL تنزيل مؤقتًا
  • استخدم Prompt واحدًا وصورة واحدة قبل أن تضيف التوليد الدفعي أو ضبط النمط

​
سلوك الاستجابة الخاص بكل model

  • يدعم dall-e-2 وdall-e-3 استجابات URL واستجابات base64
  • من الأفضل التعامل مع gpt-image-1 وgpt-image-1-mini وgpt-image-1.5 كمسارات تعتمد على base64 أولاً
  • لا يدعم qwen-image القيمة n > 1
أثناء التحقق المباشر بتاريخ 2026-03-12، أعاد طلب dall-e-3 مع response_format: "url" طابعًا زمنيًا عاديًا في created، وrevised_prompt، وURL صورة مؤقتًا.
يجب أن تمتثل الصور المُولَّدة لسياسات استخدام المزوّد. لا ترسل أوامر تتضمن محتوى غير قانوني أو عنيفًا أو إباحيًا أو منتهكًا لحقوق النشر.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
​
model
string
افتراضي:dall-e-3
مطلوب

The image generation model to use. Choose a current model from the Models page.

​
prompt
string
مطلوب

Text description of the image you want to generate.

مثال:

"A paper boat floating on calm water at sunrise."

​
n
integer
افتراضي:1

Number of images to generate. Keep this at 1 for the broadest compatibility.

​
size
string

Requested output size. Supported values depend on the selected model.

مثال:

"1024x1024"

​
response_format
enum<string>

Requested output encoding for models that support it.

الخيارات المتاحة:
url,
b64_json

الاستجابة

200 - application/json

Image generation result.

​
created
integer
مطلوب

Unix timestamp for the completed generation.

​
data
object[]
مطلوب