diff --git a/ar/guides/getting-started/openai-migration.mdx b/ar/guides/getting-started/openai-migration.mdx index 7d90ca7f..2971aada 100644 --- a/ar/guides/getting-started/openai-migration.mdx +++ b/ar/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "الانتقال من OpenAI" -description: "انقل تطبيقات chat وembeddings والصور المتوافقة مع OpenAI إلى Venice في دقائق عبر تبديل base URL ومفتاح API — نفس SDK، مع خصوصية أكبر." +description: "انقل تطبيقات OpenAI إلى Venice API عبر تبديل base URL ومفتاح API، مع جدول توافق الميزات لـ chat والصور وembeddings وTTS." "og:title": "الانتقال من OpenAI | وثائق Venice API" "og:description": "بديل جاهز عن OpenAI مع خصوصية، بدون رقابة، وتسعير تنافسي" --- @@ -80,6 +80,7 @@ OPENAI_BASE_URL=https://api.venice.ai/api/v1 | الرؤية (Vision) | ✅ | ✅ | نفس تنسيق مصفوفة المحتوى | | Embeddings | ✅ | ✅ | النص فقط؛ مصفوفات الـ tokens تُعيد HTTP 400 | | توليد الصور | ✅ | ✅ | متوافق مع OpenAI عبر `/images/generations` | +| تحرير الصور | ✅ | ❌ | لا توجد نقطة نهاية `/images/edits`؛ استخدم نقطة النهاية الأصلية [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | متوافق | | STT | ✅ | ✅ | متوافق | | Responses API | ✅ | ✅ | Alpha | diff --git a/ar/guides/media/image-editing.mdx b/ar/guides/media/image-editing.mdx index e6a4b94c..eeb31763 100644 --- a/ar/guides/media/image-editing.mdx +++ b/ar/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "تحرير الصور" -description: "حرّر الصور، وأجرِ inpaint، وركّب مدخلات متعددة الطبقات، وأزل الخلفيات باستخدام واجهات Venice المتزامنة لتحرير الصور، والتحرير المتعدد، وإزالة الخلفية." +description: "حرّر الصور، وأجرِ inpaint، وأزل الخلفيات باستخدام Venice API عبر /image/edit، وطبقات التحرير المتعدد، والأقنعة، وعناصر التحكم في الوضع الآمن." 'og:title': "Image Editing | Venice API Docs" 'og:description': "تعرّف على كيفية تحرير الصور باستخدام Venice عبر الإصلاح الموضعي المعتمد على الموجّه، ومدخلات التحرير المتعددة الطبقات، وإزالة الخلفية." --- -تحرير الصور في Venice متزامن. أرسل صورتك المصدر إلى `/image/edit` أو `/image/multi-edit` فتعود النتيجة المحرَّرة في الاستجابة ذاتها كملف PNG. أما للقصاصات (Cutouts)، فإن `/image/background-remove` يُعيد ملف PNG شفافًا. +تحرير الصور في Venice متزامن. أرسل صورتك المصدر إلى `/image/edit` أو `/image/multi-edit` فتعود النتيجة المحرَّرة في الاستجابة ذاتها كملف صورة خام. أما للقصاصات (Cutouts)، فإن `/image/background-remove` يُعيد ملف PNG شفافًا. نقاط نهاية تحرير الصور تجريبية، وقد يتغير السلوك الخاص بكل نموذج بمرور الوقت. @@ -19,6 +19,10 @@ description: "حرّر الصور، وأجرِ inpaint، وركّب مدخلات | `POST /image/multi-edit` | تحرير باستخدام 1-3 صور متراكبة | تعديلات أكثر تحكمًا باستخدام أقنعة أو طبقات | | `POST /image/background-remove` | إزالة الخلفية من صورة | قصاصات شفافة للمنتجات والصور الشخصية والأصول | + +لا توفّر Venice نقطة نهاية `/images/edits` متوافقة مع OpenAI. مسار الصور الوحيد المتوافق مع OpenAI هو `POST /images/generations` للتوليد. أما للتحرير، فاستخدم نقطة النهاية الأصلية `POST /image/edit`. + + ## متى تستخدم كل نقطة نهاية - استخدم `/image/edit` عندما تمتلك صورة مصدر واحدة وترغب في تغيير جزء منها أو إزالته أو إعادة تنسيقه بموجّه. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **الاستجابة (200):** -يحتوي جسم الاستجابة على بيانات ثنائية خام بصيغة `image/png`. احفظها مباشرة في ملف. +يحتوي جسم الاستجابة على بيانات صورة ثنائية خام. احفظها مباشرة في ملف. راجع [صيغة الاستجابة](#صيغة-الاستجابة) لمعرفة كيف يتحكّم `output_format` في نوع الملف. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -كما هو الحال في `/image/edit`، يكون جسم الاستجابة بيانات `image/png` خام. +كما هو الحال في `/image/edit`، يكون جسم الاستجابة بيانات صورة خام. تستخدم نقطة النهاية `/image/multi-edit` حاليًا الحقل `modelId` بدلاً من `model` في مخطط الطلب. @@ -205,6 +209,17 @@ curl https://api.venice.ai/api/v1/image/background-remove \ --- +## صيغة الاستجابة + +تُعيد `/image/edit` و`/image/multi-edit` دائمًا الصورة المحرَّرة كبيانات ثنائية خام (`image/png` أو `image/jpeg` أو `image/webp`). لا تقبل نقطتا نهاية التحرير المعامل `response_format`. ولا يوجد خيار `b64_json` أو `url` كما في `/images/generations`. إذا كنت بحاجة إلى النتيجة داخل JSON، فقم بترميز الاستجابة الثنائية بـ base64 في الكود الخاص بك. + +تحكّم في نوع الملف باستخدام `output_format`: + +- يقبل `output_format` القيم `jpeg` أو `jpg` أو `png` أو `webp`. +- عند حذفه، تُستنتج الصيغة من `resolution`: تكون PNG لتحريرات 1K وJPEG لتحريرات 2K و4K. + +--- + ## معاملات الطلب ### `/image/edit` @@ -215,6 +230,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | `prompt` | string | نعم | - | تعليمات نصية للتعديل | | `model` | string | لا | `qwen-edit` | معرّف نموذج التحرير | | `aspect_ratio` | string | لا | الافتراضي للنموذج | نسبة الإخراج للنماذج التي تدعمها | +| `resolution` | string | لا | `1K` | فئة الدقة للصورة الناتجة (`1K`، `2K`، `4K`)؛ تختلف القيم المدعومة بحسب النموذج | +| `output_format` | string | لا | يُستنتج من `resolution` | نوع ملف الإخراج: `jpeg` أو `jpg` أو `png` أو `webp` | | `enhance_prompt` | boolean | لا | `false` | يحلّل الصورة المُدخلة ويعيد كتابة تعليمة التحرير قبل الاستدلال | | `safe_mode` | boolean | لا | `true` | يشوّش المحتوى للبالغين في النتيجة المحرَّرة؛ اضبطه على `false` للتعطيل | | `modelId` | string | متروك (Deprecated) | - | اسم مرادف متروك للحقل `model` | @@ -226,6 +243,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | `images` | مصفوفة من 1-3 ملفات أو سلاسل base64 أو روابط URL | نعم | - | الصورة الأولى هي الأساسية؛ والباقي طبقات تحرير أو أقنعة | | `prompt` | string | نعم | - | تعليمات نصية لكيفية دمج الطبقات أو تحريرها | | `modelId` | string | لا | `qwen-edit` | معرّف نموذج التحرير | +| `resolution` | string | لا | `1K` | فئة الدقة للصورة الناتجة (`1K`، `2K`، `4K`)؛ تختلف القيم المدعومة بحسب النموذج | +| `output_format` | string | لا | يُستنتج من `resolution` | نوع ملف الإخراج: `jpeg` أو `jpg` أو `png` أو `webp` | | `enhance_prompt` | boolean | لا | `false` | يحلّل الصور المُدخلة ويعيد كتابة تعليمة التحرير قبل الاستدلال | | `safe_mode` | boolean | لا | `true` | يشوّش المحتوى للبالغين في النتيجة المحرَّرة؛ اضبطه على `false` للتعطيل | @@ -271,8 +290,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | نقطة النهاية | إدخال JSON | إدخال Multipart | الإخراج | |---|---|---|---| -| `/image/edit` | سلسلة Base64 أو رابط URL | رفع ملف | `image/png` | -| `/image/multi-edit` | سلاسل Base64 أو روابط URL | رفع ملفات | `image/png` | +| `/image/edit` | سلسلة Base64 أو رابط URL | رفع ملف | `image/png` أو `image/jpeg` أو `image/webp` بحسب `output_format` | +| `/image/multi-edit` | سلاسل Base64 أو روابط URL | رفع ملفات | `image/png` أو `image/jpeg` أو `image/webp` بحسب `output_format` | | `/image/background-remove` | سلسلة Base64 أو رابط URL | رفع ملف | `image/png` | بالنسبة لنقاط نهاية التحرير، يجب أن تكون أبعاد الصورة `65536` بكسل على الأقل وألا تتجاوز `33177600` بكسل. ويجب أن تكون الملفات المرفوعة أقل من `25MB`. diff --git a/ar/guides/media/image-generation.mdx b/ar/guides/media/image-generation.mdx index 9a7b3fdc..551261b2 100644 --- a/ar/guides/media/image-generation.mdx +++ b/ar/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "توليد الصور" -description: "أنشئ صورًا من موجّهات نصية باستخدام Venice API الأصلية للصور أو endpoint الصور المتوافقة مع OpenAI، مع تحكّم بالأسلوب ومخرجات ثنائية أو base64." +description: "أنشئ صورًا من موجّهات نصية باستخدام Venice API، مع تغطية خيارات تحديد أبعاد النماذج، والأنماط الجاهزة، وقوة LoRA، والوضع الآمن، والمخرجات الثنائية." 'og:title': "Image Generation | Venice API Docs" 'og:description': "تعرّف على كيفية توليد الصور باستخدام Venice عبر الموجّهات النصية، والخيارات الخاصة بكل نموذج، والاستجابات الثنائية أو بصيغة base64." --- @@ -227,6 +227,7 @@ curl https://api.venice.ai/api/v1/image/styles \ | `safe_mode` | boolean | لا | `true` | تشويش المحتوى للبالغين عند التفعيل | | `seed` | integer | لا | عشوائي | أعد استخدام نفس البذرة (seed) لتكرارات أكثر اتساقًا | | `cfg_scale` | number | لا | يعتمد على النموذج | القيم الأعلى تدفع النموذج لاتباع الموجّه بدقة أكبر | +| `lora_strength` | integer | لا | - | قوة (`0`-`100`) نماذج LoRA المدمجة في النموذج؛ تتجاهلها النماذج التي لا تتضمن LoRAs إضافية | | `style_preset` | string | لا | - | تطبيق نمط جاهز من [Image Styles](/api-reference/endpoint/image/styles) | | `aspect_ratio` | string | شرطي | - | يستخدم في النماذج التي تدعم تحديد الأبعاد بالنسبة، مثل `qwen-image-2` و`gpt-image-2` و`nano-banana-2` و`nano-banana-pro` | | `resolution` | string | شرطي | - | يستخدم في النماذج التي تدعم فئات دقة مثل `1K` أو `2K` أو `4K` | @@ -272,6 +273,12 @@ curl https://api.venice.ai/api/v1/image/styles \ استخدم [نماذج الصور](/models/image) لمعرفة النماذج التي تدعم دقات أعلى وكيفية تسعيرها. +### دعم LoRA + +تأتي بعض نماذج الصور مزوّدة بنماذج LoRA إضافية مدمجة. يتحكّم المعامل `lora_strength` (عدد صحيح، من `0` إلى `100`) في مدى قوة تطبيق نماذج LoRA المدمجة تلك. وهو يؤثّر فقط على النماذج التي تستخدم LoRAs إضافية. أما النماذج الأخرى فتتجاهله. + +لا تدعم واجهة API رفع ملفات LoRA مخصّصة أو تحميلها. كما لا توجد نقطة نهاية تسرد نماذج LoRA المرفقة مع نموذج معيّن. يقتصر استخدام LoRA على ضبط `lora_strength` في النماذج التي تتضمنها. + ### المحتوى للبالغين والوضع الآمن يتحكّم `safe_mode` فيما إذا كان المحتوى للبالغين في مخرجات التوليد سيُشوَّش أم لا. قيمته الافتراضية `true`. اضبطه على `false` إذا كانت حالة الاستخدام لديك تسمح بالمحتوى للبالغين وتريد الحصول على المخرجات الخام: diff --git a/de/guides/getting-started/openai-migration.mdx b/de/guides/getting-started/openai-migration.mdx index 7a56aaf0..2b5de60c 100644 --- a/de/guides/getting-started/openai-migration.mdx +++ b/de/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "Von OpenAI migrieren" -description: "Portieren Sie OpenAI-kompatible Chat-, Embeddings- und Bild-Apps in Minuten zu Venice, indem Sie Base-URL und API-Schlüssel tauschen – gleiches SDK." +description: "Migrieren Sie OpenAI-Apps zur Venice API, indem Sie Base-URL und API-Schlüssel tauschen – mit Kompatibilitätstabelle für Chat, Bilder, Embeddings und TTS." "og:title": "Von OpenAI migrieren | Venice API-Dokumentation" "og:description": "Drop-in-Ersatz für OpenAI mit Datenschutz, ohne Zensur und mit wettbewerbsfähigen Preisen" --- @@ -80,6 +80,7 @@ Durchsuchen Sie den aktuellen Katalog unter [Textmodelle](/models/text) und [Pre | Vision | ✅ | ✅ | Gleiches Content-Array-Format | | Embeddings | ✅ | ✅ | Nur Text; Token-Arrays führen zu HTTP 400 | | Bildgenerierung | ✅ | ✅ | OpenAI-kompatibel über `/images/generations` | +| Bildbearbeitung | ✅ | ❌ | Kein `/images/edits`-Endpoint; verwenden Sie das native [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | Kompatibel | | STT | ✅ | ✅ | Kompatibel | | Responses API | ✅ | ✅ | Alpha | diff --git a/de/guides/media/image-editing.mdx b/de/guides/media/image-editing.mdx index 1f0a7e5c..c3994f2f 100644 --- a/de/guides/media/image-editing.mdx +++ b/de/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "Bildbearbeitung" -description: "Bilder bearbeiten, inpainten, mehrschichtig komponieren und Hintergründe entfernen — mit Venices Edit-, Multi-Edit- und Background-Remove-APIs." +description: "Bilder bearbeiten, inpainten und Hintergründe entfernen mit der Venice API – über /image/edit, Multi-Edit-Layer, Masken und Safe-Mode-Steuerung." 'og:title': "Bildbearbeitung | Venice API Docs" 'og:description': "Lerne, wie du mit Venice Bilder bearbeitest – per Prompt-Inpainting, mehrschichtigen Multi-Edit-Inputs und Hintergrundentfernung." --- -Die Bildbearbeitung auf Venice ist synchron. Sende dein Quellbild an `/image/edit` oder `/image/multi-edit`, und das bearbeitete Ergebnis kommt in derselben Antwort als PNG-Datei zurück. Für Freisteller liefert `/image/background-remove` ein transparentes PNG. +Die Bildbearbeitung auf Venice ist synchron. Sende dein Quellbild an `/image/edit` oder `/image/multi-edit`, und das bearbeitete Ergebnis kommt in derselben Antwort als rohe Bilddatei zurück. Für Freisteller liefert `/image/background-remove` ein transparentes PNG. Die Image-Edit-Endpoints sind experimentell, und modellspezifisches Verhalten kann sich im Laufe der Zeit ändern. @@ -19,6 +19,10 @@ Die Image-Edit-Endpoints sind experimentell, und modellspezifisches Verhalten ka | `POST /image/multi-edit` | Bearbeitung mit 1–3 mehrschichtigen Bildern | Kontrolliertere Edits mit Masken oder Overlays | | `POST /image/background-remove` | Hintergrund eines Bildes entfernen | Transparente Freisteller für Produkte, Porträts und Assets | + +Venice bietet keinen OpenAI-kompatiblen `/images/edits`-Endpoint. Der einzige OpenAI-kompatible Image-Pfad ist `POST /images/generations` für die Generierung. Für die Bearbeitung nutze den nativen Endpoint `POST /image/edit`. + + ## Wann welcher Endpoint? - `/image/edit` verwenden, wenn du ein Quellbild hast und einen Teil davon per Prompt verändern, entfernen oder umstilen willst. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **Antwort (200):** -Der Response-Body sind rohe `image/png`-Binärdaten. Speichere sie direkt in eine Datei. +Der Response-Body sind rohe Bild-Binärdaten. Speichere sie direkt in eine Datei. Siehe [Antwortformat](#antwortformat) dazu, wie `output_format` den Dateityp steuert. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -Wie bei `/image/edit` sind die Response-Body rohe `image/png`-Daten. +Wie bei `/image/edit` sind die Response-Body rohe Bilddaten. `/image/multi-edit` verwendet im Request-Schema derzeit das Feld `modelId` statt `model`. @@ -205,6 +209,17 @@ Hintergrundentfernung eignet sich für: --- +## Antwortformat + +`/image/edit` und `/image/multi-edit` geben das bearbeitete Bild immer als rohe Binärdaten zurück (`image/png`, `image/jpeg` oder `image/webp`). Die Edit-Endpoints akzeptieren keinen `response_format`-Parameter. Es gibt keine `b64_json`- oder `url`-Option wie bei `/images/generations`. Wenn du das Ergebnis in JSON brauchst, kodiere die Binärantwort in deinem eigenen Code als Base64. + +Steuere den Dateityp mit `output_format`: + +- `output_format` akzeptiert `jpeg`, `jpg`, `png` oder `webp`. +- Wird der Parameter weggelassen, wird das Format aus `resolution` abgeleitet: PNG für 1K-Edits und JPEG für 2K- und 4K-Edits. + +--- + ## Request-Parameter ### `/image/edit` @@ -215,6 +230,8 @@ Hintergrundentfernung eignet sich für: | `prompt` | string | Ja | - | Text-Anweisungen für den Edit | | `model` | string | Nein | `qwen-edit` | Edit-Modell-ID | | `aspect_ratio` | string | Nein | Modell-Default | Output-Ratio bei Modellen, die das unterstützen | +| `resolution` | string | Nein | `1K` | Auflösungsstufe für das Ausgabebild (`1K`, `2K`, `4K`); unterstützte Werte variieren je nach Modell | +| `output_format` | string | Nein | aus `resolution` abgeleitet | Ausgabedateityp: `jpeg`, `jpg`, `png` oder `webp` | | `enhance_prompt` | boolean | Nein | `false` | Eingabebild analysieren und die Edit-Anweisung vor der Inferenz umschreiben | | `safe_mode` | boolean | Nein | `true` | Anstößige Inhalte im bearbeiteten Ergebnis unscharf machen. Auf `false` setzen, um die Unschärfe zu deaktivieren. | | `modelId` | string | Deprecated | - | Deprecated-Alias für `model` | @@ -226,6 +243,8 @@ Hintergrundentfernung eignet sich für: | `images` | Array aus 1–3 Dateien, Base64-Strings oder URLs | Ja | - | Erstes Bild ist das Basis-Bild; weitere sind Edit-Layer oder Masken | | `prompt` | string | Ja | - | Text-Anweisungen, wie die Layer kombiniert oder bearbeitet werden | | `modelId` | string | Nein | `qwen-edit` | Edit-Modell-ID | +| `resolution` | string | Nein | `1K` | Auflösungsstufe für das Ausgabebild (`1K`, `2K`, `4K`); unterstützte Werte variieren je nach Modell | +| `output_format` | string | Nein | aus `resolution` abgeleitet | Ausgabedateityp: `jpeg`, `jpg`, `png` oder `webp` | | `enhance_prompt` | boolean | Nein | `false` | Eingabebilder analysieren und die Edit-Anweisung vor der Inferenz umschreiben | | `safe_mode` | boolean | Nein | `true` | Anstößige Inhalte im bearbeiteten Ergebnis unscharf machen. Auf `false` setzen, um die Unschärfe zu deaktivieren. | @@ -271,8 +290,8 @@ Wird `safe_mode` an `/images/generations` übergeben, gibt es einen `400` mit `U | Endpoint | JSON-Input | Multipart-Input | Output | |---|---|---|---| -| `/image/edit` | Base64-String oder URL | Datei-Upload | `image/png` | -| `/image/multi-edit` | Base64-Strings oder URLs | Datei-Uploads | `image/png` | +| `/image/edit` | Base64-String oder URL | Datei-Upload | `image/png`, `image/jpeg` oder `image/webp` je nach `output_format` | +| `/image/multi-edit` | Base64-Strings oder URLs | Datei-Uploads | `image/png`, `image/jpeg` oder `image/webp` je nach `output_format` | | `/image/background-remove` | Base64-String oder URL | Datei-Upload | `image/png` | Für Edit-Endpoints müssen die Bilddimensionen mindestens `65536` Pixel und höchstens `33177600` Pixel betragen. Uploaded files müssen unter `25MB` sein. diff --git a/de/guides/media/image-generation.mdx b/de/guides/media/image-generation.mdx index 7bdaa346..3631dcf2 100644 --- a/de/guides/media/image-generation.mdx +++ b/de/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "Bildgenerierung" -description: "Generieren Sie Bilder aus Text-Prompts mit Venices nativer Image-API oder dem OpenAI-kompatiblen Endpoint — Stilsteuerung, Binär- oder Base64-Ausgabe." +description: "Generieren Sie Bilder aus Text-Prompts mit der Venice API – mit Modell-Größenoptionen, Style-Presets, LoRA-Stärke, Safe Mode und Binärausgabe." 'og:title': "Bildgenerierung | Venice API Docs" 'og:description': "Lerne, wie du mit Venice Bilder generierst – per Text-Prompt, modellspezifischen Optionen und Binär- oder Base64-Antworten." --- @@ -227,6 +227,7 @@ Nutze den Styles-Endpoint, wenn du exakte Preset-Namen brauchst, statt sie zu ra | `safe_mode` | boolean | Nein | `true` | Adult-Inhalte unscharf machen, wenn aktiviert | | `seed` | integer | Nein | zufällig | Denselben Seed wiederverwenden für konsistentere Iterationen | | `cfg_scale` | number | Nein | modellabhängig | Höhere Werte zwingen das Modell, dem Prompt enger zu folgen | +| `lora_strength` | integer | Nein | - | Stärke (`0`–`100`) der ins Modell eingebauten LoRAs; wird von Modellen ohne zusätzliche LoRAs ignoriert | | `style_preset` | string | Nein | - | Voreingestellten Stil aus [Image Styles](/api-reference/endpoint/image/styles) anwenden | | `aspect_ratio` | string | Bedingt | - | Wird von Modellen mit Ratio-basierter Größe verwendet, z. B. `qwen-image-2`, `gpt-image-2`, `nano-banana-2` und `nano-banana-pro` | | `resolution` | string | Bedingt | - | Wird von Modellen mit Resolution-Tiers wie `1K`, `2K` oder `4K` verwendet | @@ -272,6 +273,12 @@ Andere Image-Modelle unterstützen `aspect_ratio` plus eine `resolution`-Stufe. Nutze [Image-Modelle](/models/image), um zu sehen, welche Modelle höhere Auflösungen unterstützen und wie sie bepreist werden. +### LoRA-Support + +Manche Image-Modelle bringen zusätzliche, fest eingebaute LoRAs mit. Der Parameter `lora_strength` (integer, `0` bis `100`) steuert, wie stark diese eingebauten LoRAs angewendet werden. Er wirkt nur bei Modellen, die zusätzliche LoRAs verwenden. Andere Modelle ignorieren ihn. + +Die API unterstützt kein Hochladen oder Laden eigener LoRA-Dateien. Es gibt auch keinen Endpoint, der die mit einem Modell gebündelten LoRAs auflistet. Die LoRA-Nutzung beschränkt sich darauf, `lora_strength` bei Modellen anzupassen, die LoRAs enthalten. + ### Adult-Inhalte und Safe Mode `safe_mode` steuert, ob Adult-Inhalte in der Generierungsausgabe unscharf gemacht werden. Der Default ist `true`. Setz ihn auf `false`, wenn dein Use-Case Adult-Inhalte zulässt und du die unverfälschte Ausgabe willst: diff --git a/es/guides/getting-started/openai-migration.mdx b/es/guides/getting-started/openai-migration.mdx index 902bc68c..e518a4b5 100644 --- a/es/guides/getting-started/openai-migration.mdx +++ b/es/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "Migrar desde OpenAI" -description: "Migra apps de chat, embeddings e imágenes compatibles con OpenAI a Venice en minutos cambiando la URL base y la clave de API: mismo SDK, más privacidad." +description: "Migra apps de OpenAI a la API de Venice cambiando la URL base y la clave de API, con una tabla de compatibilidad de funciones para chat, imágenes, embeddings y TTS." "og:title": "Migrate from OpenAI | Venice API Docs" "og:description": "Sustituto drop-in para OpenAI con privacidad, sin censura y precios competitivos" --- @@ -80,6 +80,7 @@ Explora el catálogo en vivo en [Modelos de texto](/models/text) y [Precios](/ov | Visión | ✅ | ✅ | Mismo formato de array de contenido | | Embeddings | ✅ | ✅ | Solo texto; los arreglos de tokens devuelven HTTP 400 | | Generación de imágenes | ✅ | ✅ | Compatible con OpenAI mediante `/images/generations` | +| Edición de imágenes | ✅ | ❌ | No hay endpoint `/images/edits`; usa el endpoint nativo [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | Compatible | | STT | ✅ | ✅ | Compatible | | Responses API | ✅ | ✅ | Alpha | diff --git a/es/guides/media/image-editing.mdx b/es/guides/media/image-editing.mdx index 9dd66ecd..d211a73f 100644 --- a/es/guides/media/image-editing.mdx +++ b/es/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "Edición de imágenes" -description: "Edita, haz inpainting, compón entradas por capas y elimina fondos con las APIs de edición, multi-edit y eliminación de fondo de Venice." +description: "Edita, haz inpainting y elimina fondos de imágenes con la API de Venice usando /image/edit, capas multi-edit, máscaras y controles de modo seguro." 'og:title': "Image Editing | Venice API Docs" 'og:description': "Aprende a editar imágenes con Venice usando inpainting basado en prompt, entradas multi-edit en capas y eliminación de fondo." --- -La edición de imágenes en Venice es síncrona. Envía tu imagen fuente a `/image/edit` o `/image/multi-edit` y el resultado editado vuelve en la misma respuesta como archivo PNG. Para recortes, `/image/background-remove` devuelve un PNG transparente. +La edición de imágenes en Venice es síncrona. Envía tu imagen fuente a `/image/edit` o `/image/multi-edit` y el resultado editado vuelve en la misma respuesta como archivo de imagen en bruto. Para recortes, `/image/background-remove` devuelve un PNG transparente. Los endpoints de edición de imagen son experimentales y el comportamiento específico del modelo puede cambiar con el tiempo. @@ -19,6 +19,10 @@ Los endpoints de edición de imagen son experimentales y el comportamiento espec | `POST /image/multi-edit` | Edita usando 1-3 imágenes en capas | Edits más controlados con máscaras u overlays | | `POST /image/background-remove` | Elimina el fondo de una imagen | Recortes transparentes para productos, retratos y activos | + +Venice no ofrece un endpoint `/images/edits` compatible con OpenAI. La única ruta de imagen compatible con OpenAI es `POST /images/generations` para generación. Para editar, usa el endpoint nativo `POST /image/edit`. + + ## Cuándo usar cada endpoint - Usa `/image/edit` cuando tienes una imagen fuente y quieres cambiar, eliminar o restilizar parte de ella con un prompt. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **Respuesta (200):** -El cuerpo de la respuesta es datos binarios en bruto `image/png`. Guárdalos directamente en un archivo. +El cuerpo de la respuesta es datos binarios de imagen en bruto. Guárdalos directamente en un archivo. Consulta [Formato de respuesta](#formato-de-respuesta) para saber cómo `output_format` controla el tipo de archivo. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -Al igual que `/image/edit`, el cuerpo de la respuesta es datos `image/png` en bruto. +Al igual que `/image/edit`, el cuerpo de la respuesta es datos de imagen en bruto. `/image/multi-edit` usa actualmente el campo `modelId` en lugar de `model` en el esquema de la solicitud. @@ -205,6 +209,17 @@ Usa la eliminación de fondo para: --- +## Formato de respuesta + +`/image/edit` y `/image/multi-edit` siempre devuelven la imagen editada como datos binarios en bruto (`image/png`, `image/jpeg` o `image/webp`). Los endpoints de edición no aceptan un parámetro `response_format`. No hay opción `b64_json` ni `url` como en `/images/generations`. Si necesitas el resultado dentro de JSON, codifica en base64 la respuesta binaria en tu propio código. + +Controla el tipo de archivo con `output_format`: + +- `output_format` acepta `jpeg`, `jpg`, `png` o `webp`. +- Cuando se omite, el formato se infiere de `resolution`: PNG para ediciones en 1K y JPEG para ediciones en 2K y 4K. + +--- + ## Parámetros de la solicitud ### `/image/edit` @@ -215,6 +230,8 @@ Usa la eliminación de fondo para: | `prompt` | string | Sí | - | Instrucciones de texto para la edición | | `model` | string | No | `qwen-edit` | ID del modelo de edición | | `aspect_ratio` | string | No | predeterminado del modelo | Ratio de salida para los modelos que lo admiten | +| `resolution` | string | No | `1K` | Nivel de resolución de la imagen de salida (`1K`, `2K`, `4K`); los valores admitidos varían según el modelo | +| `output_format` | string | No | inferido de `resolution` | Tipo de archivo de salida: `jpeg`, `jpg`, `png` o `webp` | | `enhance_prompt` | boolean | No | `false` | Analiza la imagen de entrada y reescribe la instrucción de edición antes de la inferencia | | `safe_mode` | boolean | No | `true` | Desenfoca el contenido adulto en el resultado editado. Establece en `false` para desactivar el desenfoque. | | `modelId` | string | Deprecado | - | Alias deprecado de `model` | @@ -226,6 +243,8 @@ Usa la eliminación de fondo para: | `images` | array de 1-3 archivos, cadenas base64 o URLs | Sí | - | La primera imagen es la base; el resto son capas de edición o máscaras | | `prompt` | string | Sí | - | Instrucciones de texto sobre cómo combinar o editar las capas | | `modelId` | string | No | `qwen-edit` | ID del modelo de edición | +| `resolution` | string | No | `1K` | Nivel de resolución de la imagen de salida (`1K`, `2K`, `4K`); los valores admitidos varían según el modelo | +| `output_format` | string | No | inferido de `resolution` | Tipo de archivo de salida: `jpeg`, `jpg`, `png` o `webp` | | `enhance_prompt` | boolean | No | `false` | Analiza las imágenes de entrada y reescribe la instrucción de edición antes de la inferencia | | `safe_mode` | boolean | No | `true` | Desenfoca el contenido adulto en el resultado editado. Establece en `false` para desactivar el desenfoque. | @@ -271,8 +290,8 @@ Pasar `safe_mode` a `/images/generations` devuelve `400` con `Unrecognized key(s | Endpoint | Entrada JSON | Entrada multipart | Salida | |---|---|---|---| -| `/image/edit` | Cadena base64 o URL | Subida de archivo | `image/png` | -| `/image/multi-edit` | Cadenas base64 o URLs | Subidas de archivo | `image/png` | +| `/image/edit` | Cadena base64 o URL | Subida de archivo | `image/png`, `image/jpeg` o `image/webp` según `output_format` | +| `/image/multi-edit` | Cadenas base64 o URLs | Subidas de archivo | `image/png`, `image/jpeg` o `image/webp` según `output_format` | | `/image/background-remove` | Cadena base64 o URL | Subida de archivo | `image/png` | Para los endpoints de edición, las dimensiones de la imagen deben ser de al menos `65536` píxeles y no más de `33177600` píxeles. Los archivos subidos deben ser de menos de `25MB`. diff --git a/es/guides/media/image-generation.mdx b/es/guides/media/image-generation.mdx index b4248c6a..5166f7c1 100644 --- a/es/guides/media/image-generation.mdx +++ b/es/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "Generación de imágenes" -description: "Genera imágenes desde prompts con la API nativa de Venice o el endpoint compatible con OpenAI, con estilo y salida binaria o base64." +description: "Genera imágenes desde prompts de texto con la API de Venice, cubriendo opciones de tamaño por modelo, presets de estilo, intensidad de LoRA, modo seguro y salida binaria." 'og:title': "Image Generation | Venice API Docs" 'og:description': "Aprende a generar imágenes con Venice usando prompts de texto, opciones específicas del modelo y respuestas binarias o en base64." --- @@ -227,6 +227,7 @@ Usa el endpoint de estilos cuando quieras nombres exactos de presets en lugar de | `safe_mode` | boolean | No | `true` | Difumina contenido para adultos cuando está habilitado | | `seed` | integer | No | aleatorio | Reutiliza la misma seed para iteraciones más consistentes | | `cfg_scale` | number | No | depende del modelo | Valores más altos hacen que el modelo siga el prompt más estrictamente | +| `lora_strength` | integer | No | - | Intensidad (`0`-`100`) de los LoRAs integrados en el modelo; los modelos sin LoRAs adicionales lo ignoran | | `style_preset` | string | No | - | Aplica un estilo preset de [Image Styles](/api-reference/endpoint/image/styles) | | `aspect_ratio` | string | Condicional | - | Usado por modelos que admiten tamaño basado en ratio, como `qwen-image-2`, `gpt-image-2`, `nano-banana-2` y `nano-banana-pro` | | `resolution` | string | Condicional | - | Usado por modelos que admiten niveles de resolución como `1K`, `2K` o `4K` | @@ -272,6 +273,12 @@ Otros modelos de imagen admiten `aspect_ratio` más un nivel `resolution`. Por e Usa [Modelos de imagen](/models/image) para ver qué modelos admiten resoluciones más altas y cómo se cobran. +### Soporte de LoRA + +Algunos modelos de imagen incluyen LoRAs adicionales integrados. El parámetro `lora_strength` (integer, `0` a `100`) controla con qué intensidad se aplican esos LoRAs integrados. Solo afecta a los modelos que usan LoRAs adicionales. Los demás modelos lo ignoran. + +La API no admite subir ni cargar archivos de LoRA personalizados. Tampoco hay un endpoint que liste los LoRAs incluidos con un modelo. El uso de LoRA se limita a ajustar `lora_strength` en los modelos que los incluyen. + ### Contenido adulto y modo seguro `safe_mode` controla si el contenido adulto en la salida de generación se difumina. Su valor predeterminado es `true`. Establécelo en `false` si tu caso de uso permite contenido adulto y quieres la salida sin filtrar: diff --git a/fr/guides/getting-started/openai-migration.mdx b/fr/guides/getting-started/openai-migration.mdx index 1646a194..bc11e1ed 100644 --- a/fr/guides/getting-started/openai-migration.mdx +++ b/fr/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "Migrer depuis OpenAI" -description: "Migrez vos applications OpenAI (chat, embeddings, images) vers Venice en quelques minutes en changeant l'URL de base et la clé d'API — même SDK." +description: "Migrez vos applications OpenAI vers l'API Venice en changeant l'URL de base et la clé d'API, avec une table de compatibilité des fonctionnalités pour le chat, les images, les embeddings et le TTS." "og:title": "Migrer depuis OpenAI | Documentation de l'API Venice" "og:description": "Remplacement direct d'OpenAI, avec confidentialité, sans censure et une tarification compétitive" --- @@ -80,6 +80,7 @@ Parcourez le catalogue en direct sur [Modèles de texte](/models/text) et [Tarif | Vision | ✅ | ✅ | Même format de tableau de contenu | | Embeddings | ✅ | ✅ | Texte uniquement ; les tableaux de tokens renvoient HTTP 400 | | Génération d'images | ✅ | ✅ | Compatible OpenAI via `/images/generations` | +| Éditions d'images | ✅ | ❌ | Pas d'endpoint `/images/edits` ; utilisez l'endpoint natif [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | Compatible | | STT | ✅ | ✅ | Compatible | | API Responses | ✅ | ✅ | Alpha | diff --git a/fr/guides/media/image-editing.mdx b/fr/guides/media/image-editing.mdx index e561ac90..b8b9c50a 100644 --- a/fr/guides/media/image-editing.mdx +++ b/fr/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "Édition d'images" -description: "Éditez, retouchez par inpainting, composez des entrées en couches et supprimez les arrière-plans d'images via les API synchrones de Venice." +description: "Éditez, retouchez par inpainting et supprimez les arrière-plans d'images avec l'API Venice en utilisant /image/edit, les couches multi-édition, les masques et les contrôles du mode sûr." 'og:title': "Édition d'images | Documentation de l'API Venice" 'og:description': "Apprenez à éditer des images avec Venice en utilisant l'inpainting basé sur des prompts, des entrées multi-édition en couches et la suppression d'arrière-plan." --- -L'édition d'images sur Venice est synchrone. Envoyez votre image source à `/image/edit` ou `/image/multi-edit` et le résultat édité revient dans la même réponse sous forme de fichier PNG. Pour les détourages, `/image/background-remove` renvoie un PNG transparent. +L'édition d'images sur Venice est synchrone. Envoyez votre image source à `/image/edit` ou `/image/multi-edit` et le résultat édité revient dans la même réponse sous forme de fichier image brut. Pour les détourages, `/image/background-remove` renvoie un PNG transparent. Les endpoints d'édition d'images sont expérimentaux et le comportement spécifique au modèle peut évoluer au fil du temps. @@ -19,6 +19,10 @@ Les endpoints d'édition d'images sont expérimentaux et le comportement spécif | `POST /image/multi-edit` | Éditer en utilisant 1 à 3 images superposées | Éditions plus contrôlées avec masques ou superpositions | | `POST /image/background-remove` | Supprimer l'arrière-plan d'une image | Détourages transparents pour produits, portraits et assets | + +Venice ne fournit pas d'endpoint `/images/edits` compatible OpenAI. Le seul chemin d'image compatible OpenAI est `POST /images/generations` pour la génération. Pour l'édition, utilisez l'endpoint natif `POST /image/edit`. + + ## Quand utiliser quel endpoint - Utilisez `/image/edit` lorsque vous avez une image source et souhaitez modifier, supprimer ou restyler une partie de celle-ci avec un prompt. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **Réponse (200) :** -Le corps de la réponse est constitué de données binaires brutes `image/png`. Enregistrez-les directement dans un fichier. +Le corps de la réponse est constitué de données binaires d'image brutes. Enregistrez-les directement dans un fichier. Voir [Format de réponse](#format-de-réponse) pour savoir comment `output_format` contrôle le type de fichier. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -Comme pour `/image/edit`, le corps de la réponse est constitué de données `image/png` brutes. +Comme pour `/image/edit`, le corps de la réponse est constitué de données d'image brutes. `/image/multi-edit` utilise actuellement le champ `modelId` plutôt que `model` dans le schéma de requête. @@ -205,6 +209,17 @@ Utilisez la suppression d'arrière-plan pour : --- +## Format de réponse + +`/image/edit` et `/image/multi-edit` renvoient toujours l'image éditée sous forme de données binaires brutes (`image/png`, `image/jpeg` ou `image/webp`). Les endpoints d'édition n'acceptent pas de paramètre `response_format`. Il n'existe pas d'option `b64_json` ou `url` comme sur `/images/generations`. Si vous avez besoin du résultat dans du JSON, encodez la réponse binaire en base64 dans votre propre code. + +Contrôlez le type de fichier avec `output_format` : + +- `output_format` accepte `jpeg`, `jpg`, `png` ou `webp`. +- Lorsqu'il est omis, le format est déduit de `resolution` : PNG pour les éditions 1K et JPEG pour les éditions 2K et 4K. + +--- + ## Paramètres de la requête ### `/image/edit` @@ -215,6 +230,8 @@ Utilisez la suppression d'arrière-plan pour : | `prompt` | string | Oui | - | Instructions textuelles pour l'édition | | `model` | string | Non | `qwen-edit` | Identifiant du modèle d'édition | | `aspect_ratio` | string | Non | valeur par défaut du modèle | Ratio de sortie pour les modèles qui le prennent en charge | +| `resolution` | string | Non | `1K` | Palier de résolution pour l'image de sortie (`1K`, `2K`, `4K`) ; les valeurs prises en charge varient selon le modèle | +| `output_format` | string | Non | déduit de `resolution` | Type de fichier de sortie : `jpeg`, `jpg`, `png` ou `webp` | | `enhance_prompt` | boolean | Non | `false` | Analyser l'image d'entrée et réécrire l'instruction d'édition avant l'inférence | | `safe_mode` | boolean | Non | `true` | Floute le contenu pour adultes dans le résultat modifié. Définir sur false pour désactiver le flou. | | `modelId` | string | Déprécié | - | Alias déprécié de `model` | @@ -226,6 +243,8 @@ Utilisez la suppression d'arrière-plan pour : | `images` | tableau de 1 à 3 fichiers, chaînes base64 ou URL | Oui | - | La première image est l'image de base ; les autres sont des couches d'édition ou des masques | | `prompt` | string | Oui | - | Instructions textuelles pour combiner ou éditer les couches | | `modelId` | string | Non | `qwen-edit` | Identifiant du modèle d'édition | +| `resolution` | string | Non | `1K` | Palier de résolution pour l'image de sortie (`1K`, `2K`, `4K`) ; les valeurs prises en charge varient selon le modèle | +| `output_format` | string | Non | déduit de `resolution` | Type de fichier de sortie : `jpeg`, `jpg`, `png` ou `webp` | | `enhance_prompt` | boolean | Non | `false` | Analyser les images d'entrée et réécrire l'instruction d'édition avant l'inférence | | `safe_mode` | boolean | Non | `true` | Floute le contenu pour adultes dans le résultat modifié. Définir sur false pour désactiver le flou. | @@ -271,8 +290,8 @@ Passer `safe_mode` à `/images/generations` renvoie une erreur `400` avec `Unrec | Endpoint | Entrée JSON | Entrée multipart | Sortie | |---|---|---|---| -| `/image/edit` | Chaîne base64 ou URL | Téléversement de fichier | `image/png` | -| `/image/multi-edit` | Chaînes base64 ou URL | Téléversements de fichiers | `image/png` | +| `/image/edit` | Chaîne base64 ou URL | Téléversement de fichier | `image/png`, `image/jpeg` ou `image/webp` selon `output_format` | +| `/image/multi-edit` | Chaînes base64 ou URL | Téléversements de fichiers | `image/png`, `image/jpeg` ou `image/webp` selon `output_format` | | `/image/background-remove` | Chaîne base64 ou URL | Téléversement de fichier | `image/png` | Pour les endpoints d'édition, les dimensions de l'image doivent être d'au moins `65536` pixels et d'au plus `33177600` pixels. Les fichiers téléversés doivent faire moins de `25MB`. diff --git a/fr/guides/media/image-generation.mdx b/fr/guides/media/image-generation.mdx index e4fcf517..26bd4ad2 100644 --- a/fr/guides/media/image-generation.mdx +++ b/fr/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "Génération d'images" -description: "Générez des images à partir de prompts textuels avec l'API native de Venice ou l'endpoint compatible OpenAI, en sortie binaire ou base64." +description: "Générez des images à partir de prompts textuels avec l'API Venice, couvrant les options de dimensionnement des modèles, les presets de style, la force des LoRA, le mode sûr et la sortie binaire." 'og:title': "Génération d'images | Documentation de l'API Venice" 'og:description': "Apprenez à générer des images avec Venice en utilisant des prompts textuels, des options spécifiques aux modèles et des réponses binaires ou base64." --- @@ -227,6 +227,7 @@ Utilisez l'endpoint des styles lorsque vous voulez les noms exacts des presets p | `safe_mode` | boolean | Non | `true` | Floute le contenu pour adultes lorsque activé | | `seed` | integer | Non | aléatoire | Réutilisez la même seed pour des itérations plus cohérentes | | `cfg_scale` | number | Non | dépend du modèle | Des valeurs plus élevées poussent le modèle à suivre le prompt plus étroitement | +| `lora_strength` | integer | Non | - | Force (`0`-`100`) des LoRA intégrés au modèle ; ignoré par les modèles sans LoRA additionnels | | `style_preset` | string | Non | - | Applique un style préréglé depuis [Image Styles](/api-reference/endpoint/image/styles) | | `aspect_ratio` | string | Conditionnel | - | Utilisé par les modèles prenant en charge le dimensionnement basé sur le ratio, tels que `qwen-image-2`, `gpt-image-2`, `nano-banana-2` et `nano-banana-pro` | | `resolution` | string | Conditionnel | - | Utilisé par les modèles prenant en charge les paliers de résolution tels que `1K`, `2K` ou `4K` | @@ -272,6 +273,12 @@ D'autres modèles d'image prennent en charge `aspect_ratio` plus un palier `reso Utilisez [Modèles d'image](/models/image) pour voir quels modèles prennent en charge des résolutions plus élevées et comment ils sont tarifés. +### Support des LoRA + +Certains modèles d'image sont livrés avec des LoRA additionnels intégrés. Le paramètre `lora_strength` (entier, `0` à `100`) contrôle l'intensité avec laquelle ces LoRA intégrés sont appliqués. Il n'affecte que les modèles qui utilisent des LoRA additionnels. Les autres modèles l'ignorent. + +L'API ne prend pas en charge le téléversement ou le chargement de fichiers LoRA personnalisés. Il n'existe pas non plus d'endpoint listant les LoRA fournis avec un modèle. L'utilisation des LoRA se limite à l'ajustement de `lora_strength` sur les modèles qui en incluent. + ### Contenu adulte et mode sûr `safe_mode` contrôle si le contenu adulte présent dans la sortie de génération est flouté. La valeur par défaut est `true`. Définissez-le à `false` si votre cas d'usage autorise le contenu adulte et que vous souhaitez la sortie brute : diff --git a/guides/getting-started/openai-migration.mdx b/guides/getting-started/openai-migration.mdx index 38987159..68234813 100644 --- a/guides/getting-started/openai-migration.mdx +++ b/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "Migrate from OpenAI" -description: "Move OpenAI-compatible apps to Venice by swapping the base URL and API key." +description: "Migrate OpenAI apps to the Venice API by swapping the base URL and API key, with a feature compatibility table for chat, images, embeddings, and TTS." "og:title": "Migrate from OpenAI | Venice API Docs" "og:description": "Drop-in replacement for OpenAI with privacy, no censorship, and competitive pricing" --- @@ -80,6 +80,7 @@ Browse the live catalog on [Text models](/models/text) and [Pricing](/overview/p | Vision | ✅ | ✅ | Same content array format | | Embeddings | ✅ | ✅ | Text only; token arrays return HTTP 400 | | Image Generation | ✅ | ✅ | OpenAI-compatible via `/images/generations` | +| Image Edits | ✅ | ❌ | No `/images/edits` endpoint; use the native [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | Compatible | | STT | ✅ | ✅ | Compatible | | Responses API | ✅ | ✅ | Alpha | diff --git a/guides/media/image-editing.mdx b/guides/media/image-editing.mdx index a4669980..3e647133 100644 --- a/guides/media/image-editing.mdx +++ b/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "Image Editing" -description: "Edit, inpaint, composite, and remove backgrounds from images with the Venice image APIs." +description: "Edit, inpaint, and remove backgrounds from images with the Venice API using /image/edit, multi-edit layers, masks, and safe mode controls." 'og:title': "Image Editing | Venice API Docs" 'og:description': "Learn how to edit images with Venice using prompt-based inpainting, layered multi-edit inputs, and background removal." --- -Image editing on Venice is synchronous. Send your source image to `/image/edit` or `/image/multi-edit` and the edited result comes back in the same response as a PNG file. For cutouts, `/image/background-remove` returns a transparent PNG. +Image editing on Venice is synchronous. Send your source image to `/image/edit` or `/image/multi-edit` and the edited result comes back in the same response as a raw image file. For cutouts, `/image/background-remove` returns a transparent PNG. The image edit endpoints are experimental and model-specific behavior may change over time. @@ -19,6 +19,10 @@ The image edit endpoints are experimental and model-specific behavior may change | `POST /image/multi-edit` | Edit using 1-3 layered images | More controlled edits with masks or overlays | | `POST /image/background-remove` | Remove the background from an image | Transparent cutouts for products, portraits, and assets | + +Venice does not provide an OpenAI-compatible `/images/edits` endpoint. The only OpenAI-compatible image path is `POST /images/generations` for generation. For editing, use the native `POST /image/edit` endpoint. + + ## When to use which endpoint - Use `/image/edit` when you have one source image and want to change, remove, or restyle part of it with a prompt. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **Response (200):** -The response body is raw `image/png` binary data. Save it directly to a file. +The response body is raw image binary data. Save it directly to a file. See [Response format](#response-format) for how `output_format` controls the file type. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -Like `/image/edit`, the response body is raw `image/png` data. +Like `/image/edit`, the response body is raw image data. `/image/multi-edit` currently uses the `modelId` field rather than `model` in the request schema. @@ -205,6 +209,17 @@ Use background removal for: --- +## Response format + +`/image/edit` and `/image/multi-edit` always return the edited image as raw binary data (`image/png`, `image/jpeg`, or `image/webp`). The edit endpoints do not accept a `response_format` parameter. There is no `b64_json` or `url` option like on `/images/generations`. If you need the result inside JSON, base64-encode the binary response in your own code. + +Control the file type with `output_format`: + +- `output_format` accepts `jpeg`, `jpg`, `png`, or `webp`. +- When omitted, the format is inferred from `resolution`: PNG for 1K edits and JPEG for 2K and 4K edits. + +--- + ## Request Parameters ### `/image/edit` @@ -215,6 +230,8 @@ Use background removal for: | `prompt` | string | Yes | - | Text instructions for the edit | | `model` | string | No | `qwen-edit` | Edit model ID | | `aspect_ratio` | string | No | model default | Output ratio for models that support it | +| `resolution` | string | No | `1K` | Resolution tier for the output image (`1K`, `2K`, `4K`); supported values vary by model | +| `output_format` | string | No | inferred from `resolution` | Output file type: `jpeg`, `jpg`, `png`, or `webp` | | `enhance_prompt` | boolean | No | `false` | Analyze the input image and rewrite the edit instruction before inference | | `safe_mode` | boolean | No | `true` | Blur adult content in the edited result. Set to `false` to disable blurring. | | `modelId` | string | Deprecated | - | Deprecated alias for `model` | @@ -226,6 +243,8 @@ Use background removal for: | `images` | array of 1-3 files, base64 strings, or URLs | Yes | - | First image is the base image; the rest are edit layers or masks | | `prompt` | string | Yes | - | Text instructions for how to combine or edit the layers | | `modelId` | string | No | `qwen-edit` | Edit model ID | +| `resolution` | string | No | `1K` | Resolution tier for the output image (`1K`, `2K`, `4K`); supported values vary by model | +| `output_format` | string | No | inferred from `resolution` | Output file type: `jpeg`, `jpg`, `png`, or `webp` | | `enhance_prompt` | boolean | No | `false` | Analyze the input images and rewrite the edit instruction before inference | | `safe_mode` | boolean | No | `true` | Blur adult content in the edited result. Set to `false` to disable blurring. | @@ -271,8 +290,8 @@ Passing `safe_mode` to `/images/generations` returns `400` with `Unrecognized ke | Endpoint | JSON input | Multipart input | Output | |---|---|---|---| -| `/image/edit` | Base64 string or URL | File upload | `image/png` | -| `/image/multi-edit` | Base64 strings or URLs | File uploads | `image/png` | +| `/image/edit` | Base64 string or URL | File upload | `image/png`, `image/jpeg`, or `image/webp` per `output_format` | +| `/image/multi-edit` | Base64 strings or URLs | File uploads | `image/png`, `image/jpeg`, or `image/webp` per `output_format` | | `/image/background-remove` | Base64 string or URL | File upload | `image/png` | For edit endpoints, image dimensions must be at least `65536` pixels and no more than `33177600` pixels. Uploaded files must be under `25MB`. diff --git a/guides/media/image-generation.mdx b/guides/media/image-generation.mdx index fac7125f..46255442 100644 --- a/guides/media/image-generation.mdx +++ b/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "Image Generation" -description: "Generate images from text prompts with Venice's native or OpenAI-compatible image API." +description: "Generate images from text prompts with the Venice API, covering model sizing options, style presets, LoRA strength, safe mode, and binary output." 'og:title': "Image Generation | Venice API Docs" 'og:description': "Learn how to generate images with Venice using text prompts, model-specific options, and binary or base64 responses." --- @@ -227,6 +227,7 @@ Use the styles endpoint when you want exact preset names instead of guessing the | `safe_mode` | boolean | No | `true` | Blur adult content when enabled | | `seed` | integer | No | random | Reuse the same seed for more consistent iterations | | `cfg_scale` | number | No | model-dependent | Higher values push the model to follow the prompt more closely | +| `lora_strength` | integer | No | - | Strength (`0`-`100`) of the LoRAs built into the model; ignored by models without additional LoRAs | | `style_preset` | string | No | - | Apply a preset style from [Image Styles](/api-reference/endpoint/image/styles) | | `aspect_ratio` | string | Conditional | - | Used by models that support ratio-based sizing, such as `qwen-image-2`, `gpt-image-2`, `nano-banana-2`, and `nano-banana-pro` | | `resolution` | string | Conditional | - | Used by models that support resolution tiers such as `1K`, `2K`, or `4K` | @@ -272,6 +273,12 @@ Other image models support `aspect_ratio` plus a `resolution` tier. For example, Use [Image Models](/models/image) to see which models support higher resolutions and how they are priced. +### LoRA support + +Some image models ship with additional LoRAs built in. The `lora_strength` parameter (integer, `0` to `100`) controls how strongly those built-in LoRAs are applied. It only affects models that use additional LoRAs. Other models ignore it. + +The API does not support uploading or loading custom LoRA files. There is also no endpoint that lists the LoRAs bundled with a model. LoRA usage is limited to adjusting `lora_strength` on models that include them. + ### Adult content and safe mode `safe_mode` controls whether adult content in generation output is blurred. It defaults to `true`. Set it to `false` if your use case allows adult content and you want the raw output: diff --git a/it/guides/getting-started/openai-migration.mdx b/it/guides/getting-started/openai-migration.mdx index ded803af..b8a40e92 100644 --- a/it/guides/getting-started/openai-migration.mdx +++ b/it/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "Migrare da OpenAI" -description: "Sposta le app OpenAI-compatible di chat, embeddings e immagini su Venice in pochi minuti cambiando la base URL e la API key — stesso SDK, più privacy." +description: "Migra le app OpenAI all'API di Venice cambiando la base URL e la API key, con una tabella di compatibilità delle funzionalità per chat, immagini, embeddings e TTS." "og:title": "Migrare da OpenAI | Venice API Docs" "og:description": "Sostituto drop-in di OpenAI con privacy, nessuna censura e prezzi competitivi" --- @@ -80,6 +80,7 @@ Sfoglia il catalogo aggiornato su [Modelli di testo](/models/text) e [Prezzi](/o | Vision | ✅ | ✅ | Stesso formato per l'array content | | Embeddings | ✅ | ✅ | Solo testo; gli array di token restituiscono HTTP 400 | | Generazione di immagini | ✅ | ✅ | OpenAI-compatible tramite `/images/generations` | +| Modifica di immagini | ✅ | ❌ | Nessun endpoint `/images/edits`; usa il nativo [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | Compatibile | | STT | ✅ | ✅ | Compatibile | | Responses API | ✅ | ✅ | Alpha | diff --git a/it/guides/media/image-editing.mdx b/it/guides/media/image-editing.mdx index 2ead30c2..78ee7dd1 100644 --- a/it/guides/media/image-editing.mdx +++ b/it/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "Image editing" -description: "Modifica, fai inpainting, componi input a strati e rimuovi sfondi dalle immagini usando le API sincrone di Venice image edit, multi-edit e background-remove." +description: "Modifica, fai inpainting e rimuovi sfondi dalle immagini con l'API di Venice usando /image/edit, layer multi-edit, maschere e controlli safe mode." 'og:title': "Image Editing | Venice API Docs" 'og:description': "Scopri come modificare le immagini con Venice usando inpainting basato su prompt, input multi-edit a strati e rimozione dello sfondo." --- -L'editing di immagini su Venice è sincrono. Invia la tua immagine sorgente a `/image/edit` o `/image/multi-edit` e il risultato modificato torna nella stessa risposta come file PNG. Per i ritagli, `/image/background-remove` restituisce un PNG trasparente. +L'editing di immagini su Venice è sincrono. Invia la tua immagine sorgente a `/image/edit` o `/image/multi-edit` e il risultato modificato torna nella stessa risposta come file immagine raw. Per i ritagli, `/image/background-remove` restituisce un PNG trasparente. Gli endpoint di image edit sono sperimentali e il comportamento specifico dei modelli può cambiare nel tempo. @@ -19,6 +19,10 @@ Gli endpoint di image edit sono sperimentali e il comportamento specifico dei mo | `POST /image/multi-edit` | Modifica usando 1-3 immagini a strati | Modifiche più controllate con maschere o overlay | | `POST /image/background-remove` | Rimuove lo sfondo da un'immagine | Ritagli trasparenti per prodotti, ritratti e asset | + +Venice non fornisce un endpoint `/images/edits` compatibile con OpenAI. L'unico percorso immagini compatibile con OpenAI è `POST /images/generations` per la generazione. Per l'editing, usa l'endpoint nativo `POST /image/edit`. + + ## Quando usare quale endpoint - Usa `/image/edit` quando hai una sola immagine sorgente e vuoi cambiarne, rimuoverne o ridisegnarne una parte con un prompt. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **Risposta (200):** -Il corpo della risposta è dato binario raw `image/png`. Salvalo direttamente in un file. +Il corpo della risposta è dato binario raw dell'immagine. Salvalo direttamente in un file. Vedi [Formato di risposta](#formato-di-risposta) per come `output_format` controlla il tipo di file. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -Come per `/image/edit`, il corpo della risposta è dato raw `image/png`. +Come per `/image/edit`, il corpo della risposta è dato immagine raw. `/image/multi-edit` attualmente usa il campo `modelId` invece di `model` nello schema della richiesta. @@ -205,6 +209,17 @@ Usa la rimozione dello sfondo per: --- +## Formato di risposta + +`/image/edit` e `/image/multi-edit` restituiscono sempre l'immagine modificata come dato binario raw (`image/png`, `image/jpeg` o `image/webp`). Gli endpoint di edit non accettano un parametro `response_format`. Non esiste un'opzione `b64_json` o `url` come su `/images/generations`. Se ti serve il risultato dentro un JSON, codifica in base64 la risposta binaria nel tuo codice. + +Controlla il tipo di file con `output_format`: + +- `output_format` accetta `jpeg`, `jpg`, `png` o `webp`. +- Quando è omesso, il formato viene dedotto da `resolution`: PNG per gli edit a 1K e JPEG per gli edit a 2K e 4K. + +--- + ## Parametri della richiesta ### `/image/edit` @@ -215,6 +230,8 @@ Usa la rimozione dello sfondo per: | `prompt` | string | Sì | - | Istruzioni testuali per l'edit | | `model` | string | No | `qwen-edit` | ID del modello di edit | | `aspect_ratio` | string | No | default del modello | Rapporto d'aspetto di output per i modelli che lo supportano | +| `resolution` | string | No | `1K` | Tier di risoluzione per l'immagine di output (`1K`, `2K`, `4K`); i valori supportati variano in base al modello | +| `output_format` | string | No | dedotto da `resolution` | Tipo di file di output: `jpeg`, `jpg`, `png` o `webp` | | `enhance_prompt` | boolean | No | `false` | Analizza l'immagine di input e riscrive l'istruzione di edit prima dell'inferenza | | `safe_mode` | boolean | No | `true` | Sfoca il contenuto per adulti nel risultato modificato. Imposta su false per disattivare la sfocatura. | | `modelId` | string | Deprecato | - | Alias deprecato per `model` | @@ -226,6 +243,8 @@ Usa la rimozione dello sfondo per: | `images` | array di 1-3 file, stringhe base64 o URL | Sì | - | La prima immagine è quella di base; le altre sono layer di edit o maschere | | `prompt` | string | Sì | - | Istruzioni testuali su come combinare o modificare i layer | | `modelId` | string | No | `qwen-edit` | ID del modello di edit | +| `resolution` | string | No | `1K` | Tier di risoluzione per l'immagine di output (`1K`, `2K`, `4K`); i valori supportati variano in base al modello | +| `output_format` | string | No | dedotto da `resolution` | Tipo di file di output: `jpeg`, `jpg`, `png` o `webp` | | `enhance_prompt` | boolean | No | `false` | Analizza le immagini di input e riscrive l'istruzione di edit prima dell'inferenza | | `safe_mode` | boolean | No | `true` | Sfoca il contenuto per adulti nel risultato modificato. Imposta su false per disattivare la sfocatura. | @@ -271,8 +290,8 @@ Passare `safe_mode` a `/images/generations` restituisce `400` con `Unrecognized | Endpoint | Input JSON | Input multipart | Output | |---|---|---|---| -| `/image/edit` | Stringa base64 o URL | Upload di file | `image/png` | -| `/image/multi-edit` | Stringhe base64 o URL | Upload di file | `image/png` | +| `/image/edit` | Stringa base64 o URL | Upload di file | `image/png`, `image/jpeg` o `image/webp` in base a `output_format` | +| `/image/multi-edit` | Stringhe base64 o URL | Upload di file | `image/png`, `image/jpeg` o `image/webp` in base a `output_format` | | `/image/background-remove` | Stringa base64 o URL | Upload di file | `image/png` | Per gli endpoint di edit, le dimensioni dell'immagine devono essere almeno `65536` pixel e non più di `33177600` pixel. I file caricati devono essere inferiori a `25MB`. diff --git a/it/guides/media/image-generation.mdx b/it/guides/media/image-generation.mdx index d178d770..de10b894 100644 --- a/it/guides/media/image-generation.mdx +++ b/it/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "Generazione di immagini" -description: "Genera immagini da prompt testuali con l'API immagini nativa di Venice o l'endpoint OpenAI-compatibile, con stili e output binario o base64." +description: "Genera immagini da prompt testuali con l'API di Venice, coprendo le opzioni di dimensionamento dei modelli, i preset di stile, la forza dei LoRA, il safe mode e l'output binario." 'og:title': "Image Generation | Venice API Docs" 'og:description': "Scopri come generare immagini con Venice usando prompt testuali, opzioni specifiche per ogni modello e risposte binarie o base64." --- @@ -227,6 +227,7 @@ Usa l'endpoint degli stili quando vuoi i nomi esatti dei preset invece di indovi | `safe_mode` | boolean | No | `true` | Sfoca i contenuti per adulti quando abilitato | | `seed` | integer | No | casuale | Riutilizza lo stesso seed per iterazioni più consistenti | | `cfg_scale` | number | No | dipende dal modello | Valori più alti spingono il modello a seguire più da vicino il prompt | +| `lora_strength` | integer | No | - | Forza (`0`-`100`) dei LoRA integrati nel modello; ignorato dai modelli senza LoRA aggiuntivi | | `style_preset` | string | No | - | Applica uno stile preset da [Image Styles](/api-reference/endpoint/image/styles) | | `aspect_ratio` | string | Condizionale | - | Usato dai modelli che supportano il dimensionamento basato su ratio, come `qwen-image-2`, `gpt-image-2`, `nano-banana-2` e `nano-banana-pro` | | `resolution` | string | Condizionale | - | Usato dai modelli che supportano tier di risoluzione come `1K`, `2K` o `4K` | @@ -272,6 +273,12 @@ Altri modelli di immagini supportano `aspect_ratio` più un tier di `resolution` Usa [Modelli di immagini](/models/image) per vedere quali modelli supportano risoluzioni più alte e come sono prezzati. +### Supporto LoRA + +Alcuni modelli di immagini includono LoRA aggiuntivi integrati. Il parametro `lora_strength` (intero, da `0` a `100`) controlla con quanta forza vengono applicati questi LoRA integrati. Influisce solo sui modelli che usano LoRA aggiuntivi. Gli altri modelli lo ignorano. + +L'API non supporta il caricamento di file LoRA personalizzati. Non esiste inoltre un endpoint che elenchi i LoRA inclusi in un modello. L'uso dei LoRA si limita a regolare `lora_strength` sui modelli che li includono. + ### Contenuti per adulti e safe mode `safe_mode` controlla se i contenuti per adulti nell'output della generazione vengono sfocati. Il default è `true`. Impostalo a `false` se il tuo caso d'uso ammette contenuti per adulti e vuoi l'output grezzo: diff --git a/ko/guides/getting-started/openai-migration.mdx b/ko/guides/getting-started/openai-migration.mdx index ea05ceaa..0bc52a31 100644 --- a/ko/guides/getting-started/openai-migration.mdx +++ b/ko/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "OpenAI에서 마이그레이션" -description: "base URL과 API 키만 교체하면 OpenAI 호환 chat completions, embeddings, image 애플리케이션을 몇 분 안에 Venice API로 이전할 수 있습니다. 동일한 SDK로 더 강력한 프라이버시를 얻고 코드 변경 없이 마이그레이션합니다." +description: "base URL과 API 키를 교체해 OpenAI 앱을 Venice API로 마이그레이션하세요. chat, images, embeddings, TTS의 기능 호환성 표를 함께 제공합니다." "og:title": "Migrate from OpenAI | Venice API Docs" "og:description": "Drop-in replacement for OpenAI with privacy, no censorship, and competitive pricing" --- @@ -80,6 +80,7 @@ Venice 모델 ID, `default`나 `most_uncensored`와 같은 특성(trait), 또는 | Vision | ✅ | ✅ | 동일한 content 배열 형식 | | Embeddings | ✅ | ✅ | 텍스트만 지원; 토큰 배열은 HTTP 400 반환 | | 이미지 생성 | ✅ | ✅ | `/images/generations`를 통한 OpenAI 호환 | +| 이미지 편집 | ✅ | ❌ | `/images/edits` 엔드포인트 없음. 네이티브 [`/image/edit`](/guides/media/image-editing)를 사용하세요 | | TTS | ✅ | ✅ | 호환 | | STT | ✅ | ✅ | 호환 | | Responses API | ✅ | ✅ | 알파 | diff --git a/ko/guides/media/image-editing.mdx b/ko/guides/media/image-editing.mdx index 7b9f44ef..21a445e7 100644 --- a/ko/guides/media/image-editing.mdx +++ b/ko/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "이미지 편집" -description: "Venice의 동기식 image edit, multi-edit, background-remove API를 사용해 이미지를 편집·인페인팅하고, 여러 레이어 입력을 합성하며, 배경을 자동으로 제거하는 워크플로우를 요청 파라미터 예제와 함께 안내합니다." +description: "Venice API의 /image/edit, multi-edit 레이어, 마스크, safe mode 제어를 사용해 이미지를 편집·인페인팅하고 배경을 제거하세요." 'og:title': "Image Editing | Venice API Docs" 'og:description': "prompt 기반 inpainting, 레이어드 multi-edit input, 배경 제거를 활용해 Venice로 이미지를 편집하는 방법을 알아보세요." --- -Venice의 이미지 편집은 동기 방식입니다. 원본 이미지를 `/image/edit` 또는 `/image/multi-edit`로 보내면 편집된 결과가 같은 응답에 PNG 파일로 돌아옵니다. 누끼 작업에는 `/image/background-remove`가 투명한 PNG를 반환합니다. +Venice의 이미지 편집은 동기 방식입니다. 원본 이미지를 `/image/edit` 또는 `/image/multi-edit`로 보내면 편집된 결과가 같은 응답에 raw 이미지 파일로 돌아옵니다. 누끼 작업에는 `/image/background-remove`가 투명한 PNG를 반환합니다. 이미지 편집 endpoint는 실험적이며 모델별 동작은 시간이 지남에 따라 변경될 수 있습니다. @@ -19,6 +19,10 @@ Venice의 이미지 편집은 동기 방식입니다. 원본 이미지를 `/imag | `POST /image/multi-edit` | 1-3장의 레이어드 이미지로 편집 | 마스크나 오버레이가 있는 더 제어된 편집 | | `POST /image/background-remove` | 이미지에서 배경 제거 | 제품, 인물, 자산을 위한 투명 컷아웃 | + +Venice는 OpenAI 호환 `/images/edits` endpoint를 제공하지 않습니다. 유일한 OpenAI 호환 이미지 경로는 생성을 위한 `POST /images/generations`입니다. 편집에는 네이티브 `POST /image/edit` endpoint를 사용하세요. + + ## 어떤 endpoint를 언제 사용하나요 - 원본 이미지가 하나이고 prompt로 일부를 변경, 제거, 재스타일링하고 싶다면 `/image/edit`를 사용하세요. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **응답(200):** -응답 본문은 raw `image/png` 바이너리 데이터입니다. 그대로 파일에 저장하세요. +응답 본문은 raw 이미지 바이너리 데이터입니다. 그대로 파일에 저장하세요. `output_format`이 파일 타입을 제어하는 방법은 [응답 포맷](#응답-포맷)을 참조하세요. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -`/image/edit`와 마찬가지로 응답 본문은 raw `image/png` 데이터입니다. +`/image/edit`와 마찬가지로 응답 본문은 raw 이미지 데이터입니다. `/image/multi-edit`는 현재 요청 스키마에서 `model`이 아닌 `modelId` 필드를 사용합니다. @@ -205,6 +209,17 @@ curl https://api.venice.ai/api/v1/image/background-remove \ --- +## 응답 포맷 + +`/image/edit`와 `/image/multi-edit`는 편집된 이미지를 항상 raw 바이너리 데이터(`image/png`, `image/jpeg`, 또는 `image/webp`)로 반환합니다. 편집 endpoint는 `response_format` 파라미터를 받지 않습니다. `/images/generations`처럼 `b64_json`이나 `url` 옵션도 없습니다. 결과가 JSON 안에 필요하다면 바이너리 응답을 직접 코드에서 base64로 인코딩하세요. + +`output_format`으로 파일 타입을 제어하세요: + +- `output_format`은 `jpeg`, `jpg`, `png`, 또는 `webp`를 받습니다. +- 생략하면 `resolution`에서 포맷이 추론됩니다: 1K 편집은 PNG, 2K와 4K 편집은 JPEG입니다. + +--- + ## 요청 파라미터 ### `/image/edit` @@ -215,6 +230,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | `prompt` | string | 예 | - | 편집을 위한 텍스트 지시 | | `model` | string | 아니오 | `qwen-edit` | 편집 모델 ID | | `aspect_ratio` | string | 아니오 | 모델 기본값 | 지원 모델의 출력 비율 | +| `resolution` | string | 아니오 | `1K` | 출력 이미지의 해상도 등급(`1K`, `2K`, `4K`). 지원 값은 모델별로 다름 | +| `output_format` | string | 아니오 | `resolution`에서 추론 | 출력 파일 타입: `jpeg`, `jpg`, `png`, 또는 `webp` | | `enhance_prompt` | boolean | 아니오 | `false` | 입력 이미지를 분석하고 추론 전에 편집 지시를 다시 작성 | | `safe_mode` | boolean | 아니오 | `true` | 편집된 결과에서 성인 콘텐츠를 흐리게 처리합니다. `false`로 설정하면 흐림이 비활성화됩니다 | | `modelId` | string | Deprecated | - | `model`의 deprecated 별칭 | @@ -226,6 +243,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | `images` | 1-3개의 파일, base64 문자열, 또는 URL 배열 | 예 | - | 첫 이미지는 base 이미지, 나머지는 편집 레이어나 마스크 | | `prompt` | string | 예 | - | 레이어를 결합하거나 편집하는 방법에 대한 텍스트 지시 | | `modelId` | string | 아니오 | `qwen-edit` | 편집 모델 ID | +| `resolution` | string | 아니오 | `1K` | 출력 이미지의 해상도 등급(`1K`, `2K`, `4K`). 지원 값은 모델별로 다름 | +| `output_format` | string | 아니오 | `resolution`에서 추론 | 출력 파일 타입: `jpeg`, `jpg`, `png`, 또는 `webp` | | `enhance_prompt` | boolean | 아니오 | `false` | 입력 이미지들을 분석하고 추론 전에 편집 지시를 다시 작성 | | `safe_mode` | boolean | 아니오 | `true` | 편집된 결과에서 성인 콘텐츠를 흐리게 처리합니다. `false`로 설정하면 흐림이 비활성화됩니다 | @@ -271,8 +290,8 @@ Endpoint 간 모더레이션 이름 차이는 사람들을 헷갈리게 만드 | Endpoint | JSON input | Multipart input | Output | |---|---|---|---| -| `/image/edit` | Base64 문자열 또는 URL | 파일 업로드 | `image/png` | -| `/image/multi-edit` | Base64 문자열 또는 URL | 파일 업로드 | `image/png` | +| `/image/edit` | Base64 문자열 또는 URL | 파일 업로드 | `output_format`에 따라 `image/png`, `image/jpeg`, 또는 `image/webp` | +| `/image/multi-edit` | Base64 문자열 또는 URL | 파일 업로드 | `output_format`에 따라 `image/png`, `image/jpeg`, 또는 `image/webp` | | `/image/background-remove` | Base64 문자열 또는 URL | 파일 업로드 | `image/png` | 편집 endpoint의 경우 이미지 크기는 최소 `65536` 픽셀, 최대 `33177600` 픽셀이어야 합니다. 업로드 파일은 `25MB` 미만이어야 합니다. diff --git a/ko/guides/media/image-generation.mdx b/ko/guides/media/image-generation.mdx index c6a1f5f3..93aa9491 100644 --- a/ko/guides/media/image-generation.mdx +++ b/ko/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "이미지 생성" -description: "Venice 네이티브 이미지 API 또는 OpenAI 호환 images 엔드포인트를 사용해 텍스트 프롬프트로 이미지를 생성하고, 스타일 제어와 바이너리(binary)·base64 출력 형식, 시드 제어를 활용하는 방법을 예제와 함께 안내합니다." +description: "Venice API로 텍스트 프롬프트에서 이미지를 생성하는 방법을 모델 크기 옵션, 스타일 프리셋, LoRA 강도, safe mode, 바이너리 출력과 함께 안내합니다." 'og:title': "Image Generation | Venice API Docs" 'og:description': "텍스트 prompt, 모델별 옵션, 바이너리 또는 base64 응답을 사용해 Venice로 이미지를 생성하는 방법을 알아보세요." --- @@ -227,6 +227,7 @@ curl https://api.venice.ai/api/v1/image/styles \ | `safe_mode` | boolean | 아니오 | `true` | 활성화 시 성인 콘텐츠 블러 처리 | | `seed` | integer | 아니오 | 무작위 | 더 일관된 반복을 위해 동일 seed 재사용 | | `cfg_scale` | number | 아니오 | 모델별 | 값이 높을수록 모델이 prompt를 더 충실히 따름 | +| `lora_strength` | integer | 아니오 | - | 모델에 내장된 LoRA의 강도(`0`-`100`). 추가 LoRA가 없는 모델에서는 무시됨 | | `style_preset` | string | 아니오 | - | [Image Styles](/api-reference/endpoint/image/styles)의 프리셋 스타일 적용 | | `aspect_ratio` | string | 조건부 | - | `qwen-image-2`, `gpt-image-2`, `nano-banana-2`, `nano-banana-pro` 같은 비율 기반 크기 모델에서 사용 | | `resolution` | string | 조건부 | - | `1K`, `2K`, `4K` 같은 해상도 등급을 지원하는 모델에서 사용 | @@ -272,6 +273,12 @@ curl https://api.venice.ai/api/v1/image/styles \ 어떤 모델이 더 높은 해상도를 지원하는지, 그리고 가격은 어떻게 되는지는 [이미지 모델](/models/image)에서 확인하세요. +### LoRA 지원 + +일부 이미지 모델에는 추가 LoRA가 내장되어 있습니다. `lora_strength` 파라미터(정수, `0`에서 `100`)는 내장 LoRA가 얼마나 강하게 적용되는지 제어합니다. 추가 LoRA를 사용하는 모델에만 영향을 주며, 다른 모델은 이를 무시합니다. + +API는 커스텀 LoRA 파일의 업로드나 로드를 지원하지 않습니다. 모델에 번들된 LoRA를 나열하는 endpoint도 없습니다. LoRA 사용은 LoRA가 포함된 모델에서 `lora_strength`를 조정하는 것으로 제한됩니다. + ### 성인 콘텐츠 및 safe mode `safe_mode`는 생성 output의 성인 콘텐츠를 블러 처리할지 여부를 제어합니다. 기본값은 `true`입니다. 사용 사례에서 성인 콘텐츠가 허용되고 원본 output을 원한다면 `false`로 설정하세요: diff --git a/pt-BR/guides/getting-started/openai-migration.mdx b/pt-BR/guides/getting-started/openai-migration.mdx index 4f200d7b..aad26fc1 100644 --- a/pt-BR/guides/getting-started/openai-migration.mdx +++ b/pt-BR/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "Migre da OpenAI" -description: "Migre apps de chat, embeddings e imagens compatíveis com OpenAI para a Venice em minutos trocando a base URL e a chave de API — mesmo SDK, mais privacidade." +description: "Migre apps OpenAI para a API Venice trocando a base URL e a chave de API, com uma tabela de compatibilidade de recursos para chat, imagens, embeddings e TTS." "og:title": "Migre da OpenAI | Documentação da API Venice" "og:description": "Substituição direta da OpenAI com privacidade, sem censura e preços competitivos" --- @@ -80,6 +80,7 @@ Navegue pelo catálogo ao vivo em [Modelos de texto](/models/text) e [Preços](/ | Visão | ✅ | ✅ | Mesmo formato de array de conteúdo | | Embeddings | ✅ | ✅ | Apenas texto; arrays de tokens retornam HTTP 400 | | Geração de imagem | ✅ | ✅ | Compatível com OpenAI via `/images/generations` | +| Edição de imagens | ✅ | ❌ | Sem endpoint `/images/edits`; use o nativo [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | Compatível | | STT | ✅ | ✅ | Compatível | | Responses API | ✅ | ✅ | Alpha | diff --git a/pt-BR/guides/media/image-editing.mdx b/pt-BR/guides/media/image-editing.mdx index ed825d4b..7c5b070f 100644 --- a/pt-BR/guides/media/image-editing.mdx +++ b/pt-BR/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "Edição de imagens" -description: "Edite, faça inpainting, componha entradas em camadas e remova fundos com as APIs síncronas de edição, multi-edição e remoção de fundo da Venice." +description: "Edite, faça inpainting e remova fundos de imagens com a API Venice usando /image/edit, camadas de multi-edição, máscaras e controles de safe mode." 'og:title': "Edição de imagens | Documentação da API Venice" 'og:description': "Aprenda a editar imagens com a Venice usando inpainting baseado em prompt, entradas multi-edit em camadas e remoção de fundo." --- -A edição de imagens na Venice é síncrona. Envie sua imagem de origem para `/image/edit` ou `/image/multi-edit` e o resultado editado volta na mesma resposta como um arquivo PNG. Para recortes, `/image/background-remove` retorna um PNG transparente. +A edição de imagens na Venice é síncrona. Envie sua imagem de origem para `/image/edit` ou `/image/multi-edit` e o resultado editado volta na mesma resposta como um arquivo de imagem cru. Para recortes, `/image/background-remove` retorna um PNG transparente. Os endpoints de edição de imagem são experimentais e o comportamento específico de cada modelo pode mudar com o tempo. @@ -19,6 +19,10 @@ Os endpoints de edição de imagem são experimentais e o comportamento específ | `POST /image/multi-edit` | Edita usando 1-3 imagens em camadas | Edições mais controladas com máscaras ou overlays | | `POST /image/background-remove` | Remove o fundo de uma imagem | Recortes transparentes para produtos, retratos e assets | + +A Venice não fornece um endpoint `/images/edits` compatível com OpenAI. O único caminho de imagem compatível com OpenAI é `POST /images/generations` para geração. Para edição, use o endpoint nativo `POST /image/edit`. + + ## Quando usar cada endpoint - Use `/image/edit` quando tiver uma imagem de origem e quiser alterar, remover ou reestilizar parte dela com um prompt. @@ -51,7 +55,7 @@ Content-Type: application/json ``` **Resposta (200):** -O corpo da resposta são dados binários crus `image/png`. Salve-os diretamente em um arquivo. +O corpo da resposta são dados binários crus de imagem. Salve-os diretamente em um arquivo. Veja [Formato de resposta](#formato-de-resposta) para saber como `output_format` controla o tipo de arquivo. ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -Como `/image/edit`, o corpo da resposta são dados crus `image/png`. +Como `/image/edit`, o corpo da resposta são dados crus de imagem. `/image/multi-edit` atualmente usa o campo `modelId` em vez de `model` no schema de requisição. @@ -205,6 +209,17 @@ Use a remoção de fundo para: --- +## Formato de resposta + +`/image/edit` e `/image/multi-edit` sempre retornam a imagem editada como dados binários crus (`image/png`, `image/jpeg` ou `image/webp`). Os endpoints de edição não aceitam um parâmetro `response_format`. Não há opção `b64_json` ou `url` como em `/images/generations`. Se você precisar do resultado dentro de JSON, codifique a resposta binária em base64 no seu próprio código. + +Controle o tipo de arquivo com `output_format`: + +- `output_format` aceita `jpeg`, `jpg`, `png` ou `webp`. +- Quando omitido, o formato é inferido a partir de `resolution`: PNG para edições em 1K e JPEG para edições em 2K e 4K. + +--- + ## Parâmetros da requisição ### `/image/edit` @@ -215,6 +230,8 @@ Use a remoção de fundo para: | `prompt` | string | Sim | - | Instruções de texto para a edição | | `model` | string | Não | `qwen-edit` | ID do modelo de edição | | `aspect_ratio` | string | Não | padrão do modelo | Proporção de saída para modelos que a suportam | +| `resolution` | string | Não | `1K` | Tier de resolução da imagem de saída (`1K`, `2K`, `4K`); os valores suportados variam por modelo | +| `output_format` | string | Não | inferido de `resolution` | Tipo de arquivo de saída: `jpeg`, `jpg`, `png` ou `webp` | | `enhance_prompt` | boolean | Não | `false` | Analisa a imagem de entrada e reescreve a instrução de edição antes da inferência | | `safe_mode` | boolean | Não | `true` | Embaça conteúdo adulto no resultado editado. Defina como `false` para desabilitar o embaçamento. | | `modelId` | string | Obsoleto | - | Alias obsoleto para `model` | @@ -226,6 +243,8 @@ Use a remoção de fundo para: | `images` | array de 1-3 arquivos, strings base64 ou URLs | Sim | - | A primeira imagem é a base; o restante são camadas de edição ou máscaras | | `prompt` | string | Sim | - | Instruções de texto sobre como combinar ou editar as camadas | | `modelId` | string | Não | `qwen-edit` | ID do modelo de edição | +| `resolution` | string | Não | `1K` | Tier de resolução da imagem de saída (`1K`, `2K`, `4K`); os valores suportados variam por modelo | +| `output_format` | string | Não | inferido de `resolution` | Tipo de arquivo de saída: `jpeg`, `jpg`, `png` ou `webp` | | `enhance_prompt` | boolean | Não | `false` | Analisa as imagens de entrada e reescreve a instrução de edição antes da inferência | | `safe_mode` | boolean | Não | `true` | Embaça conteúdo adulto no resultado editado. Defina como `false` para desabilitar o embaçamento. | @@ -271,8 +290,8 @@ Passar `safe_mode` para `/images/generations` retorna `400` com `Unrecognized ke | Endpoint | Entrada JSON | Entrada multipart | Saída | |---|---|---|---| -| `/image/edit` | String base64 ou URL | Upload de arquivo | `image/png` | -| `/image/multi-edit` | Strings base64 ou URLs | Uploads de arquivo | `image/png` | +| `/image/edit` | String base64 ou URL | Upload de arquivo | `image/png`, `image/jpeg` ou `image/webp` conforme `output_format` | +| `/image/multi-edit` | Strings base64 ou URLs | Uploads de arquivo | `image/png`, `image/jpeg` ou `image/webp` conforme `output_format` | | `/image/background-remove` | String base64 ou URL | Upload de arquivo | `image/png` | Para endpoints de edição, as dimensões da imagem devem ser de no mínimo `65536` pixels e no máximo `33177600` pixels. Arquivos enviados devem ter menos de `25MB`. diff --git a/pt-BR/guides/media/image-generation.mdx b/pt-BR/guides/media/image-generation.mdx index 8f5ad3df..c300d757 100644 --- a/pt-BR/guides/media/image-generation.mdx +++ b/pt-BR/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "Geração de imagens" -description: "Gere imagens a partir de texto com a API nativa da Venice ou o endpoint compatível com OpenAI, com controles de estilo e saída binária ou em base64." +description: "Gere imagens a partir de prompts de texto com a API Venice, cobrindo opções de dimensionamento por modelo, presets de estilo, força de LoRA, safe mode e saída binária." 'og:title': "Geração de imagens | Documentação da API Venice" 'og:description': "Aprenda a gerar imagens com a Venice usando prompts de texto, opções específicas de modelo e respostas binárias ou em base64." --- @@ -227,6 +227,7 @@ Use o endpoint de estilos quando quiser nomes exatos de presets em vez de adivin | `safe_mode` | boolean | Não | `true` | Embaça conteúdo adulto quando habilitado | | `seed` | integer | Não | aleatório | Reutilize o mesmo seed para iterações mais consistentes | | `cfg_scale` | number | Não | dependente do modelo | Valores mais altos fazem o modelo seguir o prompt mais de perto | +| `lora_strength` | integer | Não | - | Força (`0`-`100`) dos LoRAs integrados ao modelo; ignorado por modelos sem LoRAs adicionais | | `style_preset` | string | Não | - | Aplica um estilo predefinido de [Image Styles](/api-reference/endpoint/image/styles) | | `aspect_ratio` | string | Condicional | - | Usado por modelos que suportam dimensionamento por proporção, como `qwen-image-2`, `gpt-image-2`, `nano-banana-2` e `nano-banana-pro` | | `resolution` | string | Condicional | - | Usado por modelos que suportam tiers de resolução como `1K`, `2K` ou `4K` | @@ -272,6 +273,12 @@ Outros modelos de imagem suportam `aspect_ratio` mais um tier `resolution`. Por Use [Modelos de imagem](/models/image) para ver quais modelos suportam resoluções maiores e como são precificados. +### Suporte a LoRA + +Alguns modelos de imagem vêm com LoRAs adicionais integrados. O parâmetro `lora_strength` (integer, `0` a `100`) controla a intensidade com que esses LoRAs integrados são aplicados. Ele só afeta modelos que usam LoRAs adicionais. Outros modelos o ignoram. + +A API não suporta upload nem carregamento de arquivos LoRA personalizados. Também não há um endpoint que liste os LoRAs incluídos em um modelo. O uso de LoRA se limita a ajustar `lora_strength` nos modelos que os incluem. + ### Conteúdo adulto e safe mode `safe_mode` controla se o conteúdo adulto na saída da geração é borrado. O padrão é `true`. Defina como `false` se o seu caso de uso permitir conteúdo adulto e você quiser a saída sem alteração: diff --git a/zh/guides/getting-started/openai-migration.mdx b/zh/guides/getting-started/openai-migration.mdx index f5c25fba..075de25f 100644 --- a/zh/guides/getting-started/openai-migration.mdx +++ b/zh/guides/getting-started/openai-migration.mdx @@ -1,6 +1,6 @@ --- title: "从 OpenAI 迁移" -description: "只需更换 base URL 与 API 密钥，即可在几分钟内将兼容 OpenAI 的 chat completions、embeddings 和图像生成应用完整迁移到 Venice API 上运行，使用同一套 SDK 获得更强的隐私保护，无需重写任何业务代码。" +description: "只需更换 base URL 和 API 密钥，即可将 OpenAI 应用迁移到 Venice API，并附有涵盖 chat、图像、embeddings 和 TTS 的特性兼容性表。" "og:title": "Migrate from OpenAI | Venice API Docs" "og:description": "Drop-in replacement for OpenAI with privacy, no censorship, and competitive pricing" --- @@ -80,6 +80,7 @@ OPENAI_BASE_URL=https://api.venice.ai/api/v1 | Vision | ✅ | ✅ | 相同的 content 数组格式 | | Embeddings | ✅ | ✅ | 仅支持文本；token 数组会返回 HTTP 400 | | Image Generation | ✅ | ✅ | 通过 `/images/generations` 兼容 OpenAI | +| Image Edits | ✅ | ❌ | 无 `/images/edits` 端点；请使用原生 [`/image/edit`](/guides/media/image-editing) | | TTS | ✅ | ✅ | 兼容 | | STT | ✅ | ✅ | 兼容 | | Responses API | ✅ | ✅ | Alpha | diff --git a/zh/guides/media/image-editing.mdx b/zh/guides/media/image-editing.mdx index 7ab4918a..87981b91 100644 --- a/zh/guides/media/image-editing.mdx +++ b/zh/guides/media/image-editing.mdx @@ -1,11 +1,11 @@ --- title: "图像编辑" -description: "使用 Venice 提供的同步 image edit、multi-edit 和 background-remove 三个 REST API，对图像进行编辑、inpaint 修复、多层输入合成以及背景自动移除等常见操作，本页附带完整的请求参数说明与 curl 示例代码。" +description: "使用 Venice API 通过 /image/edit、multi-edit 图层、遮罩和安全模式控制，对图像进行编辑、inpaint 修复和背景移除。" 'og:title': "Image Editing | Venice API Docs" 'og:description': "Learn how to edit images with Venice using prompt-based inpainting, layered multi-edit inputs, and background removal." --- -Venice 上的图像编辑是同步的。将源图像发送到 `/image/edit` 或 `/image/multi-edit`，编辑后的结果会在同一响应中以 PNG 文件形式返回。对于抠图，`/image/background-remove` 返回透明 PNG。 +Venice 上的图像编辑是同步的。将源图像发送到 `/image/edit` 或 `/image/multi-edit`，编辑后的结果会在同一响应中以原始图像文件形式返回。对于抠图，`/image/background-remove` 返回透明 PNG。 图像编辑端点是实验性的，模型特有行为可能会随时间变化。 @@ -19,6 +19,10 @@ Venice 上的图像编辑是同步的。将源图像发送到 `/image/edit` 或 | `POST /image/multi-edit` | 使用 1-3 张分层图像编辑 | 借助遮罩或叠加层实现更可控的编辑 | | `POST /image/background-remove` | 移除图像背景 | 产品、人像和素材的透明抠图 | + +Venice 不提供 OpenAI 兼容的 `/images/edits` 端点。唯一 OpenAI 兼容的图像路径是用于生成的 `POST /images/generations`。如需编辑，请使用原生 `POST /image/edit` 端点。 + + ## 何时使用哪个端点 - 当您有一张源图像并希望用 prompt 改变、移除或重新风格化其部分时，使用 `/image/edit`。 @@ -51,7 +55,7 @@ Content-Type: application/json ``` **响应（200）：** -响应体是原始的 `image/png` 二进制数据。直接保存为文件即可。 +响应体是原始图像二进制数据。直接保存为文件即可。有关 `output_format` 如何控制文件类型，请参见[响应格式](#响应格式)。 ```python Python @@ -147,7 +151,7 @@ curl https://api.venice.ai/api/v1/image/multi-edit \ -o multi-edited.png ``` -与 `/image/edit` 一样，响应体是原始的 `image/png` 数据。 +与 `/image/edit` 一样，响应体是原始图像数据。 `/image/multi-edit` 目前在请求 schema 中使用 `modelId` 字段，而非 `model`。 @@ -205,6 +209,17 @@ curl https://api.venice.ai/api/v1/image/background-remove \ --- +## 响应格式 + +`/image/edit` 和 `/image/multi-edit` 始终以原始二进制数据（`image/png`、`image/jpeg` 或 `image/webp`）返回编辑后的图像。编辑端点不接受 `response_format` 参数。也没有像 `/images/generations` 上那样的 `b64_json` 或 `url` 选项。如果您需要在 JSON 中获取结果，请在自己的代码中对二进制响应进行 base64 编码。 + +使用 `output_format` 控制文件类型： + +- `output_format` 接受 `jpeg`、`jpg`、`png` 或 `webp`。 +- 省略时，格式会根据 `resolution` 推断：1K 编辑为 PNG，2K 和 4K 编辑为 JPEG。 + +--- + ## 请求参数 ### `/image/edit` @@ -215,6 +230,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | `prompt` | string | 是 | - | 编辑的文本指令 | | `model` | string | 否 | `qwen-edit` | 编辑模型 ID | | `aspect_ratio` | string | 否 | 模型默认 | 支持的模型的输出比例 | +| `resolution` | string | 否 | `1K` | 输出图像的分辨率等级（`1K`、`2K`、`4K`）；支持的值因模型而异 | +| `output_format` | string | 否 | 根据 `resolution` 推断 | 输出文件类型：`jpeg`、`jpg`、`png` 或 `webp` | | `enhance_prompt` | boolean | 否 | `false` | 分析输入图像并在推理前重写编辑指令 | | `safe_mode` | boolean | 否 | `true` | 对编辑结果中的成人内容进行模糊处理。设置为 `false` 可禁用模糊 | | `modelId` | string | 已弃用 | - | `model` 的已弃用别名 | @@ -226,6 +243,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | `images` | 1-3 个文件、base64 字符串或 URL 的数组 | 是 | - | 第一张是基础图像；其余为编辑层或遮罩 | | `prompt` | string | 是 | - | 关于如何组合或编辑层的文本指令 | | `modelId` | string | 否 | `qwen-edit` | 编辑模型 ID | +| `resolution` | string | 否 | `1K` | 输出图像的分辨率等级（`1K`、`2K`、`4K`）；支持的值因模型而异 | +| `output_format` | string | 否 | 根据 `resolution` 推断 | 输出文件类型：`jpeg`、`jpg`、`png` 或 `webp` | | `enhance_prompt` | boolean | 否 | `false` | 分析输入图像并在推理前重写编辑指令 | | `safe_mode` | boolean | 否 | `true` | 对编辑结果中的成人内容进行模糊处理。设置为 `false` 可禁用模糊 | @@ -271,8 +290,8 @@ curl https://api.venice.ai/api/v1/image/background-remove \ | 端点 | JSON 输入 | Multipart 输入 | 输出 | |---|---|---|---| -| `/image/edit` | Base64 字符串或 URL | 文件上传 | `image/png` | -| `/image/multi-edit` | Base64 字符串或 URL | 文件上传 | `image/png` | +| `/image/edit` | Base64 字符串或 URL | 文件上传 | 根据 `output_format` 为 `image/png`、`image/jpeg` 或 `image/webp` | +| `/image/multi-edit` | Base64 字符串或 URL | 文件上传 | 根据 `output_format` 为 `image/png`、`image/jpeg` 或 `image/webp` | | `/image/background-remove` | Base64 字符串或 URL | 文件上传 | `image/png` | 对于编辑端点，图像尺寸必须至少为 `65536` 像素且不超过 `33177600` 像素。上传文件必须小于 `25MB`。 diff --git a/zh/guides/media/image-generation.mdx b/zh/guides/media/image-generation.mdx index b7b7ea19..6e8e60ed 100644 --- a/zh/guides/media/image-generation.mdx +++ b/zh/guides/media/image-generation.mdx @@ -1,6 +1,6 @@ --- title: "图像生成" -description: "使用 Venice 原生图像生成 API 或与 OpenAI 兼容的 images 端点，从文本 prompt 生成图像，支持多种风格控制、种子（seed）控制以及二进制（binary）或 base64 格式的响应输出，本页附完整示例代码、常见参数说明及可用模型列表。" +description: "使用 Venice API 从文本 prompt 生成图像，涵盖模型尺寸选项、风格预设、LoRA 强度、安全模式和二进制输出。" 'og:title': "Image Generation | Venice API Docs" 'og:description': "Learn how to generate images with Venice using text prompts, model-specific options, and binary or base64 responses." --- @@ -227,6 +227,7 @@ curl https://api.venice.ai/api/v1/image/styles \ | `safe_mode` | boolean | 否 | `true` | 启用时模糊成人内容 | | `seed` | integer | 否 | 随机 | 重用相同 seed 以实现更一致的迭代 | | `cfg_scale` | number | 否 | 模型相关 | 较高值推动模型更紧密地遵循 prompt | +| `lora_strength` | integer | 否 | - | 模型内置 LoRA 的强度（`0`-`100`）；没有额外 LoRA 的模型会忽略该参数 | | `style_preset` | string | 否 | - | 从[图像风格](/api-reference/endpoint/image/styles)应用预设风格 | | `aspect_ratio` | string | 条件 | - | 由支持基于比例尺寸的模型使用，例如 `qwen-image-2`、`gpt-image-2`、`nano-banana-2` 和 `nano-banana-pro` | | `resolution` | string | 条件 | - | 由支持分辨率分级（如 `1K`、`2K` 或 `4K`）的模型使用 | @@ -272,6 +273,12 @@ curl https://api.venice.ai/api/v1/image/styles \ 使用[图像模型](/models/image)查看哪些模型支持更高分辨率及其定价。 +### LoRA 支持 + +某些图像模型内置了额外的 LoRA。`lora_strength` 参数（整数，`0` 到 `100`）控制这些内置 LoRA 的应用强度。它只影响使用额外 LoRA 的模型。其他模型会忽略它。 + +API 不支持上传或加载自定义 LoRA 文件。也没有可以列出模型所捆绑 LoRA 的端点。LoRA 的使用仅限于在包含 LoRA 的模型上调整 `lora_strength`。 + ### 成人内容与安全模式 `safe_mode` 控制生成输出中的成人内容是否被模糊处理。默认为 `true`。如果您的使用场景允许成人内容并且希望获取原始输出，请将其设为 `false`：