الانتقال إلى المحتوى الرئيسي

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.

استخدم وثائق نماذج الصور في CometAPI باختيار تنسيق الطلب الذي يطابق سير عملك. تغطي نقاط نهاية الصور المتوافقة مع OpenAI تدفقات الإنشاء والتحرير الشائعة؛ بينما تغطي الصفحات الخاصة بكل مزود أنظمة الصور القائمة على المهام.

​
اختر واجهة برمجة تطبيقات للصور

Image Generations

أنشئ صورًا باستخدام طلب متوافق مع OpenAI.

Image Editing

حرّر الصور باستخدام طلب متوافق مع OpenAI.

Gemini image generation

أنشئ الصور أو حررها باستخدام تنسيق Gemini.

Midjourney quick start

أرسل مهام صور Midjourney وتابع حالتها باستطلاع دوري.

Flux Generate Image

أنشئ صور Flux عبر CometAPI.

Bria Generate Image

استخدم أدوات إنشاء صور Bria.

​
أنشئ صورة

استخدم model ID قادرًا على الصور من صفحة Models أو دليل النماذج. تستدعي الأمثلة أدناه واجهة برمجة التطبيقات الخاصة بـ Image Generations المتوافقة مع OpenAI.
تستخدم هذه الأمثلة العنصر النائب your-image-model-id. استبدله بـ model ID متاح للصور من صفحة Models أو دليل النماذج قبل تشغيل الطلب.
افتح Image Generations لاستخدام ساحة التجربة ومخطط نقطة النهاية.
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/images/generations",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-image-model-id",
        "prompt": "A clean product photo of a glass teapot on a white table",
        "size": "1024x1024",
    },
    timeout=120,
)

response.raise_for_status()
result = response.json()
print(result["data"][0].keys())

​
مثال على الاستجابة

يمكن أن تبدو الاستجابة الناجحة كما يلي. اعتمادًا على النموذج المحدد، يمكن أن يحتوي كل عنصر على صورة بصيغة base64 أو على عنوان URL للنتيجة: 
{
  "created": 1779872000,
  "background": "opaque",
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 19,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 19
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 215
  }
}

​
أمثلة على سجلات النماذج

يوضح رد فهرس النماذج المثال هذا الغلاف /api/models وبنية سجل واحد لنموذج صورة. وهو ليس قائمة نماذج كاملة.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1776391310,
      "id": "your-image-model-id",
      "code": "your-image-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example image model",
      "model_type": "image",
      "features": [
        "text-to-image"
      ],
      "endpoints": "{\n  \"openai-image\": {\n    \"path\": \"/v1/images/generations\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 4,
        "output": 24,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

​
الأخطاء الشائعة

اختر model قادرًا على الصور من صفحة Models.
استخدم حجمًا يقبله مسار الصور المحدد.
نزّل الأصول التي تم إنشاؤها قبل انتهاء صلاحية روابط المزوّد.
استخدم عناوين URL للصور أو ملفات أصغر بدلًا من الحمولات base64 الكبيرة.
تحقّق من حقلي b64_json وurl لأن شكل المخرجات يمكن أن يختلف حسب النموذج.

​
رموز الأخطاء واستراتيجية إعادة المحاولة

لا تعِد المحاولة حتى يتم إصلاح prompt أو size أو إدخال الصورة.
لا تعِد المحاولة حتى تكون API key موجودة وصالحة.
تحقّق من base URL وpath وmodel ID قبل إعادة المحاولة.
قلّل حجم الرفع قبل إعادة المحاولة.
أعد المحاولة باستخدام exponential backoff وقلّل التوازي.
أعد المحاولة باستخدام backoff لأخطاء المزوّد أو الخدمة العابرة.
لأنماط التنفيذ، راجع Error codes and retry strategy وRate limits and concurrency.

​
التسعير ودليل النماذج

Models page

اقرأ كيف يعرّض CometAPI model IDs في الوثائق.

Model directory

استعرض توفر النماذج وقدراتها.

Pricing

تحقّق من التسعير قبل استدعاء نموذج.
Last modified on May 28, 2026