بالتأكيد، إليك ترجمة لوثائق Reve Art API باللغة العربية:

توثيق واجهة برمجة تطبيقات Reve Art

مرحباً بك في وثائق واجهة برمجة تطبيقات (API) Reve Art لتوليد الصور. تقدم هذه الخدمة إمكانات متطورة لتوليد الصور باستخدام الذكاء الاصطناعي، وذلك من خلال واجهة برمجة تطبيقات (API) بسيطة تعتمد على بروتوكول REST.

مقدمة عن Reve Image 1.0

Reve Image 1.0 هو النموذج الرائد لدينا لتوليد الصور من النصوص، وقد تم تصميمه مع التركيز على:

• الالتزام الفائق بالمطالبات (Prompt)
• جودة جمالية عالية
• عرض دقيق للطباعة
• توليد صور بديهي من النصوص

تم تصميم هذا النموذج لإنتاج نتائج عالية الجودة دون الحاجة إلى خبرة متقدمة في هندسة المطالبات، مما يجعله في متناول كل من المبتدئين والمستخدمين ذوي الخبرة. يمكنك تجربته مجانًا من خلال إنشاء صورة.

حالات الاستخدام

يمكن دمج واجهة برمجة تطبيقات Reve Art في تطبيقات متنوعة:

• إنشاء المحتوى: توليد صور فريدة للمدونات والمقالات ووسائل التواصل الاجتماعي
• التجارة الإلكترونية: إنشاء نماذج أولية للمنتجات وتغييراتها
• التصميم والنماذج الأولية: تصور مفاهيم التصميم بسرعة
• الألعاب والترفيه: توليد أصول الألعاب وتصميمات الشخصيات
• التعليم: إنشاء مواد ورسوم توضيحية تعليمية

المصادقة

تتطلب جميع طلبات واجهة برمجة التطبيقات المصادقة باستخدام مفتاح API.

أضف مفتاح API إلى رأس Authorization:

curl -X POST https://reve-art.com/v1/reve-image/generate \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"prompt": "your prompt here", "aspect_ratio": "1:1"}'

كيفية الحصول على مفتاح API

يرجى تسجيل الدخول وإضافة مفتاح API الخاص بك في صفحة لوحة التحكم > مفاتيح API.

ثم استخدم مفتاح API لتوليد الصور.

توليد صورة

تتيح لك نقطة نهاية توليد الصور إنشاء صور من أوصاف نصية. يمكنك التحكم في جوانب مختلفة من عملية التوليد من خلال المعلمات.

أفضل الممارسات

1. هندسة المطالبات

   • كن محددًا وواصفًا في مطالباتك
   • استخدم المصطلحات الفنية لتوجيه الأسلوب
   • قم بتضمين تفاصيل حول الإضاءة والمنظور والحالة المزاجية

2. اختيار نسبة العرض إلى الارتفاع

   • اختر بناءً على حالة الاستخدام المقصودة
   • 1:1 لمنشورات وسائل التواصل الاجتماعي
   • 16:9 للعروض التقديمية / اللافتات
   • 9:16 لمحتوى الجوال

3. التوليد غير المتزامن

   • استخدم async=true للتوليد الأطول
   • قم بتنفيذ استطلاع الحالة (Status Polling) لتحسين تجربة المستخدم

POST /v1/images/generate

نص الطلب

{
  "prompt": "string",           // مطلوب: المطالبة بتوليد الصورة
  "negative_prompt": "string",  // اختياري: أشياء لتجنبها في الصورة
  "aspect_ratio": "string",    // مطلوب: نسبة العرض إلى الارتفاع للصورة (الافتراضي: "1:1")
  "async": boolean             // اختياري: توليد غير متزامن (الافتراضي: false)
}

نسبة العرض إلى الارتفاع

نسبة العرض إلى الارتفاع للصورة. النسب المدعومة: "1:1"، "16:9"، "4:3"، "3:4"، "9:16"، "2:3"، "3:2".

استجابة متزامنة

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "your prompt",
    "width": 1024,
    "height": 1024,
    "created_at": "2024-01-01T00:00:00Z"
  }
}

استجابة غير متزامنة

{
  "id": "img_123",
  "status": "pending"
}

مثال على الاستخدام

بايثون:

import requests

api_key = "your_api_key"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.reve-art.com/v1/reve-image/generate",
    headers=headers,
    json={
        "prompt": "a beautiful sunset over mountains",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"Image URL: {result['url']}")
else:
    print(f"Error: {response.text}")

Node.js:

async function generateImage(prompt: string) {
  const response = await fetch("https://api.reve-art.com/v1/reve-image/generate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt,
      aspect_ratio: "1:1",
      async: true,
    }),
  });

  if (!response.ok) {
    throw new Error(`Failed to generate image: ${response.statusText}`);
  }

  const result = await response.json();
  
  if (result.status === "pending") {
    // Poll for completion
    return await checkImageStatus(result.id);
  }

  return result;
}

التحقق من حالة الصورة

GET /v1/reve-image/status/image_id

الاستجابة

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "original prompt",
    "width": 1024,
    "height": 1024,
    "model": "text2image_v1",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

مثال على الاستخدام

async function checkImageStatus(imageId: string) {
  const response = await fetch(
    `https://reve-art.com/v1/reve-image/status/${imageId}/`,
    {
      headers: {
        "Authorization": `Bearer ${apiKey}`,
      },
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to check status: ${response.statusText}`);
  }

  return await response.json();
}

حدود المعدل

تخضع طلبات واجهة برمجة التطبيقات للحدود التي يحددها اشتراكك والاعتمادات المتاحة.

• تكلفة كل توليد صورة هي 1 ائتمان
• الخطة المجانية: 3 اعتمادات متضمنة
• الخطة الأساسية: 100 اعتماد شهريًا
• الحد الأقصى للمعدل: 10 طلبات في الدقيقة
• إذا كنت بحاجة إلى المزيد من الاعتمادات، فيرجى ترقية خطتك أو شراء المزيد من الاعتمادات.