الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1776841943,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 16,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 16
    },
    "output_tokens": 208,
    "total_tokens": 224
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

استخدم هذا المسار لإنشاء صور من النص باستخدام صيغ طلبات متوافقة مع OpenAI على CometAPI.

​
المرجع الرسمي

​
اختر model أولاً

  • استخدم dall-e-3 عندما تريد طلبًا أوليًا بسيطًا مع response_format
  • استخدم model صور GPT عندما تحتاج إلى عناصر تحكم خاصة بـ GPT مثل output_format أو quality أو background
  • استخدم qwen-image عندما تحتاج إلى هذا المزود تحديدًا، ولكن أبقِ n على 1

​
أول طلب آمن

  • ابدأ بـ dall-e-3
  • أبقِ size على 1024x1024
  • اضبط response_format: "url" إذا كنت تريد استجابة JSON صغيرة ورابط تنزيل مؤقت
  • استخدم مثال طلب GPT المتحقق منه في مرجع API إذا كنت بحاجة إلى معلمات model صور GPT
  • أضف output_format فقط عندما تحتاج إلى نوع صورة مُرمّز محدد مثل jpeg
  • راجع دليل OpenAI لتوليد الصور قبل إضافة background أو output_compression أو Streaming
  • استخدم Prompt واحدًا وصورة ناتجة واحدة قبل إضافة التوليد الدفعي أو ضبط النمط

​
سلوك الطلب الخاص بكل model

  • ينطبق response_format على dall-e-2 وdall-e-3
  • تستخدم نماذج صور GPT عناصر تحكم خاصة بـ GPT مثل output_format وquality وbackground وoutput_compression
  • اتبع دليل OpenAI لتوليد الصور للحصول على أحدث الخيارات الخاصة بكل model
  • لا يدعم qwen-image القيمة n > 1
يجب أن تمتثل الصور المُولَّدة لسياسات استخدام المزود. لا ترسل مطالبات غير قانونية أو عنيفة أو إباحية أو تنتهك حقوق النشر.

التفويضات

​
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.

​
quality
string

Quality setting for models that support it. See the OpenAI image generation guide for the latest model-specific values.

​
size
string

Requested output size. Supported values depend on the selected model. See the OpenAI image generation guide for the latest model-specific ranges.

مثال:

"1024x1024"

​
response_format
enum<string>

The response container for dall-e-2 and dall-e-3. This parameter is not supported for GPT image models, which return base64-encoded image data.

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

The encoded image type for GPT image model results, such as png, jpeg, or webp. See the OpenAI image generation guide for current GPT image output controls.

مثال:

"jpeg"

الاستجابة

200 - application/json

Image generation result.

​
created
integer
مطلوب

Unix timestamp for the completed generation.

​
usage
object
مطلوب
​
data
object[]
مطلوب
​
background
string

Background mode returned by models that expose it.

​
output_format
string

Encoded image type returned by GPT image models.

​
quality
string

Quality level returned by models that expose it.

​
size
string

Output size returned by models that expose it.