تحسين الموجّهات

​

متى تستخدمه

• يكون موجّهك قصيرًا (بضع كلمات أو عبارة واحدة) وتريد من النموذج أن يملأ التركيبة والإضاءة والأجواء.
• تبني منتجًا يكتب فيه المستخدمون النهائيون موجّهات عادية تستفيد من التوسيع.
• تحرّر صورة وتريد إعادة كتابة التعليمة مع الوعي بمحتواها المرئي.
• تريد مخرجات أكثر تفصيلًا وثباتًا دون كتابة موجّهات طويلة يدويًا.

​

الخطوة 1: أرسل طلبًا مع تفعيل التحسين

curl https://api.venice.ai/api/v1/image/generate \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-sd35",
    "prompt": "a cabin in the woods",
    "enhance_prompt": true,
    "format": "webp"
  }'

​

الخطوة 2: اقرأ الموجّه المُحسَّن من ترويسة الاستجابة

import base64
import os
from urllib.parse import unquote

import requests

response = requests.post(
    "https://api.venice.ai/api/v1/image/generate",
    headers={
        "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "venice-sd35",
        "prompt": "a cabin in the woods",
        "enhance_prompt": True,
        "format": "webp",
    },
)

data = response.json()

enhanced = response.headers.get("x-venice-enhanced-prompt")
if enhanced:
    print("Enhanced prompt:", unquote(enhanced))
else:
    print("No enhancement was applied; original prompt was used.")

image_bytes = base64.b64decode(data["images"][0])
with open("output.webp", "wb") as f:
    f.write(image_bytes)

import fs from "fs";

const response = await fetch("https://api.venice.ai/api/v1/image/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "venice-sd35",
    prompt: "a cabin in the woods",
    enhance_prompt: true,
    format: "webp",
  }),
});

const data = await response.json();

const enhanced = response.headers.get("x-venice-enhanced-prompt");
if (enhanced) {
  console.log("Enhanced prompt:", decodeURIComponent(enhanced));
} else {
  console.log("No enhancement was applied; original prompt was used.");
}

const imageBuffer = Buffer.from(data.images[0], "base64");
fs.writeFileSync("output.webp", imageBuffer);

​

استخدام التحسين لتحرير الصور

curl https://api.venice.ai/api/v1/image/edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o edited.png \
  -d '{
    "image": "https://example.com/cabin.jpg",
    "prompt": "make it winter",
    "enhance_prompt": true
  }'

curl https://api.venice.ai/api/v1/image/multi-edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o edited.png \
  -d '{
    "images": [
      "https://example.com/cabin.jpg",
      "https://example.com/snow-reference.jpg"
    ],
    "prompt": "make the first image match this winter atmosphere",
    "enhance_prompt": true
  }'

​

السلوك

​

التسعير

• تُحاسَب فقط عند توليد إعادة كتابة وتطبيقها فعليًا. إذا تم تخطي التحسين أو فشل بشكل مرن إلى موجّهك الأصلي، فلا رسم إضافي.
• تُفوتر الرسوم الإضافية على مسار نجاح الصورة. إذا انتهى التوليد بانتهاك محتوى، فلا يُحاسَب التحسين.
• عند طلب صور متعددة باستخدام variants، تُفوتر إعادة الكتابة المشتركة مرة واحدة على الأكثر لكل طلب، وليس مرة لكل نسخة.

​

استخدام التحسين مع variants

curl https://api.venice.ai/api/v1/image/generate \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-sd35",
    "prompt": "a cabin in the woods",
    "enhance_prompt": true,
    "variants": 4
  }'

​

نصائح للموجّهات

1. أبقِ موجّه الإدخال مركّزًا على الموضوع وأي تفاصيل غير قابلة للتفاوض. يملأ التحسين الأسلوب والإضاءة والتركيبة حوله.
2. سجّل ترويسة x-venice-enhanced-prompt أثناء التطوير لتتعلم ما يضيفه التحسين وتقرر متى تفضّل كتابة الموجّهات يدويًا.
3. للحصول على نتائج توليد قابلة للتكرار عبر دفعة، ولّد مرة واحدة مع التحسين، والتقط الموجّه المُحسَّن من الترويسة، ثم أعد استخدام هذا النص بالضبط مع تعطيل enhance_prompt.
4. لتوليد الصور، اجمع الموجّه الملتقط مع seed ثابتة لمقارنة تغييرات المعاملات الأخرى دون إعادة كتابة.

​

الأخطاء

​

ذات صلة

• توليد الصور — دليل التوليد الكامل، بما في ذلك الأبعاد والأنماط والاستجابات الثنائية.
• تحرير الصور — تحرير الصورة الواحدة، وطلبات التحرير المتعدد بالطبقات، والاستجابات الثنائية.
• Generate Images (API reference) — كل حقول الطلب والاستجابة لـ POST /image/generate.
• Edit Image (API reference) — حقول الطلب لـ POST /image/edit.
• Multi-Edit Image (API reference) — حقول الطلب لـ POST /image/multi-edit.
• نماذج الصور — قائمة النماذج والتسعير وpromptCharacterLimit لكل نموذج.