واجهة برمجة تحرير Seedream 5.0: تحرير الصور برمجياً

واجهات الويب رائعة للتعديلات الفردية. أما واجهات برمجة التطبيقات فهي الطريقة المثلى لتعديل 10,000 صورة في ليلة واحدة. تمنحك واجهة برمجة تطبيقات Seedream 5.0 Edit وصولاً برمجياً إلى نفس نموذج التعديل باللغة الطبيعية الذي يشغّل منصة Arteza، بنفس السعر $0.10 لكل تعديل. يرشدك هذا الدليل عبر المصادقة ونقاط النهاية وأمثلة Python وJavaScript وأنماط المعالجة الدفعية وأفضل الممارسات في بيئة الإنتاج.

ملخص سريع

• وصول برمجي إلى Seedream 5.0 Edit بسعر $0.10 لكل تعديل (1 كريدت)
• واجهة REST API مع استجابات JSON، وزمن توليد يتراوح بين 5 و15 ثانية
• أمثلة بلغتَي Python وJavaScript مضمّنة
• مصمّمة لسير العمل الدفعي، تعالج آلاف الصور في كل مهمة
• 10 كريدت مجاني للاختبار على arteza.ai

متى تستخدم واجهة برمجة التطبيقات بدلاً من واجهة الويب

استخدم واجهة الويب عندما:

• تعدّل من 1 إلى 20 صورة يدوياً
• تريد التكرار بصرياً
• تستكشف توجهات إبداعية

استخدم واجهة برمجة التطبيقات عندما:

• تعدّل 50 صورة أو أكثر
• تبني منتجاً يعدّل الصور
• تحتاج إلى تعليمات موحّدة عبر دفعة كاملة
• تريد دمج التعديل في خط أنابيب موجود (تصدير Lightroom، Shopify، نظام إدارة المحتوى، إلخ)

المصادقة

تعتمد واجهة برمجة التطبيقات على مصادقة رمز الحامل. احصل على مفتاح API من لوحة تحكم Arteza بعد التسجيل.

# احفظ مفتاحك كمتغير بيئة
export SEEDANCE_API_KEY="your_api_key_here"

لا تُدرج مفاتيح API في git أبداً. استخدم متغيرات البيئة أو مديري الأسرار أو ملفات .env.

نقطة نهاية التعديل

نقطة النهاية: POST https://api.arteza.ai/v1/edit

المعاملات المطلوبة:

المعاملات الاختيارية:

كل استدعاء ناجح يخصم 1 كريدت.

مثال بلغة Python

import os
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
API_URL = "https://api.arteza.ai/v1/edit"

def edit_image(image_path: str, prompt: str) -> bytes:
    with open(image_path, "rb") as f:
        files = {"image": f}
        data = {
            "prompt": prompt,
            "model": "seedream-5-lite-edit",
            "output_format": "png",
        }
        headers = {"Authorization": f"Bearer {API_KEY}"}
        response = requests.post(
            API_URL, files=files, data=data, headers=headers, timeout=60
        )
        response.raise_for_status()
        return response.content

# الاستخدام
edited = edit_image(
    "product.jpg",
    "Replace background with seamless white studio, add soft shadow"
)
with open("product_edited.png", "wb") as f:
    f.write(edited)

مثال بلغة JavaScript / Node.js

import fs from "fs";
import FormData from "form-data";
import axios from "axios";

const API_KEY = process.env.SEEDANCE_API_KEY;
const API_URL = "https://api.arteza.ai/v1/edit";

async function editImage(imagePath, prompt) {
  const form = new FormData();
  form.append("image", fs.createReadStream(imagePath));
  form.append("prompt", prompt);
  form.append("model", "seedream-5-lite-edit");
  form.append("output_format", "png");

  const response = await axios.post(API_URL, form, {
    headers: {
      ...form.getHeaders(),
      Authorization: `Bearer ${API_KEY}`,
    },
    responseType: "arraybuffer",
    timeout: 60000,
  });

  return response.data;
}

// الاستخدام
const edited = await editImage(
  "product.jpg",
  "Apply warm golden-hour cinematic color grade"
);
fs.writeFileSync("product_edited.png", edited);

مثال باستخدام cURL

curl -X POST https://api.arteza.ai/v1/edit \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -F "[email protected]" \
  -F "prompt=Replace background with clean white studio" \
  -F "model=seedream-5-lite-edit" \
  -o product_edited.png

هل تريد نتائج كهذه؟ جرّب Seedream 5.0 Edit مجاناً →

نمط المعالجة الدفعية

حالة الاستخدام الأبرز لواجهة برمجة التطبيقات هي المعالجة الدفعية. إليك نمط Python جاهز للإنتاج:

import os
import concurrent.futures
from pathlib import Path

def process_batch(image_dir: str, prompt: str, output_dir: str, workers: int = 4):
    Path(output_dir).mkdir(parents=True, exist_ok=True)
    images = list(Path(image_dir).glob("*.jpg"))

    def process_one(img_path: Path):
        try:
            result = edit_image(str(img_path), prompt)
            output_path = Path(output_dir) / f"{img_path.stem}_edited.png"
            with open(output_path, "wb") as f:
                f.write(result)
            return (img_path.name, "success")
        except Exception as e:
            return (img_path.name, f"error: {e}")

    with concurrent.futures.ThreadPoolExecutor(max_workers=workers) as executor:
        results = list(executor.map(process_one, images))

    for name, status in results:
        print(f"{name}: {status}")

# تعديل 100 صورة منتج بنفس التعليمة
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

الأداء: مع 4 عمال متوازيين، تستغرق معالجة 100 صورة نحو 3-5 دقائق إجمالاً. التكلفة: 100 × 1 كريدت = 100 كريدت = $10 إجمالاً.

معالجة الأخطاء

تُعيد واجهة برمجة التطبيقات رموز حالة HTTP القياسية:

نمط إعادة المحاولة

import time
import requests

def edit_with_retry(image_path: str, prompt: str, max_retries: int = 3):
    for attempt in range(max_retries):
        try:
            return edit_image(image_path, prompt)
        except requests.HTTPError as e:
            if e.response.status_code in (429, 500, 502, 503, 504):
                wait = 2 ** attempt  # تراجع أسي: 1 ثانية، 2 ثانية، 4 ثوانٍ
                time.sleep(wait)
                continue
            raise
    raise Exception("تجاوز الحد الأقصى لإعادة المحاولة")

سير عمل Webhook للدفعات الكبيرة

للمهام التي تضم آلاف الصور، استخدم Webhooks لتجنب الاستطلاع المتواصل:

# أرسل مهمة مع رابط Webhook
response = requests.post(
    f"{API_URL}/batch",
    json={
        "model": "seedream-5-lite-edit",
        "images": ["s3://bucket/img1.jpg", "s3://bucket/img2.jpg", ...],
        "prompt": "Replace background with white studio",
        "webhook": "https://yourapp.com/webhook/seedance",
    },
    headers={"Authorization": f"Bearer {API_KEY}"},
)
job_id = response.json()["job_id"]

# ستُرسل Arteza النتائج إلى Webhook الخاص بك عند اكتمال المهمة

حدود معدل الطلبات

إذا كنت بحاجة إلى حدود أعلى، تواصل مع الدعم من لوحة التحكم الخاصة بك.

أنماط الإنتاج الشائعة

1. خط أنابيب منتجات Shopify

# اسحب المنتجات الجديدة من Shopify → عدّلها → ارفعها مجدداً
for product in new_products:
    for image_url in product.images:
        edited = edit_image_url(image_url, BRAND_PROMPT)
        upload_to_shopify(product.id, edited)

راجع دليل صور المنتجات للحصول على أفكار حول التعليمات.

2. أتمتة قوائم العقارات

# تحسين صور القوائم الجديدة تلقائياً
for photo in listing.photos:
    if photo.type == "exterior":
        edited = edit_image(photo.path, "Replace sky with blue clear sky, brighten")
    elif photo.type == "interior_empty":
        edited = edit_image(photo.path, "Stage in modern Scandinavian style")
    save_to_mls(edited)

راجع دليل التأثيث الافتراضي للحصول على قوالب التعليمات.

3. خط أنابيب محتوى وسائل التواصل الاجتماعي

# توليد نسخ متعددة المنصات لكل منشور
for source_image in incoming_posts:
    instagram = edit_image(source_image, "Bright airy Instagram aesthetic")
    tiktok = edit_image(source_image, "High-energy saturated TikTok look")
    linkedin = edit_image(source_image, "Clean corporate LinkedIn tones")
    publish_to_platforms(instagram, tiktok, linkedin)

راجع دليل وسائل التواصل الاجتماعي.

تتبع التكاليف

كل استدعاء لواجهة برمجة التطبيقات يخصم 1 كريدت. تتبّع إنفاقك برمجياً:

def get_credit_balance():
    response = requests.get(
        "https://api.arteza.ai/v1/account/credits",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    return response.json()["balance"]

print(f"الكريدت المتبقي: {get_credit_balance()}")

الأسعار

يتجدد الكريدت الشهري مع كل دورة فوترة. كريدت الإضافة لا تنتهي صلاحيته أبداً. الأسعار الكاملة.

قائمة التحقق للإنتاج

• مفتاح API محفوظ بأمان (متغير بيئة أو مدير أسرار)
• منطق إعادة المحاولة مع التراجع الأسي
• تسجيل الأخطاء والتنبيهات
• مراقبة رصيد الكريدت
• تزامن مراعٍ لحدود معدل الطلبات
• التحقق من حجم صورة الإدخال (<2048 بكسل)
• تخزين المخرجات (CDN، S3، إلخ)
• قوالب التعليمات مُصدَّرة في git

الخطوات التالية

• الدليل الكامل لـ Seedream 5.0 Edit
• سير عمل تصوير المنتجات
• أتمتة العقارات
• إنشاء تنويعات على نطاق واسع

احصل على مفتاح API مجاناً → - كريدت مجاني عند التسجيل، دون الحاجة إلى بطاقة ائتمانية.