Hy Image 3.5 Preview API
نموذج توليد وتحرير صور من تينسنت، إصدار معاينة يوازن بين الجودة الاحترافية والتكلفة، ويدعم حتى 5 صور مرجعية ودقة تصل إلى 4K ونصوصًا متعددة اللغات.
يُعد Hy Image 3.5 Preview إصدار معاينة من تينسنت لتوليد الصور وتحريرها، يجمع بين إدخال النص وإدخال الصور وإخراج الصور. يقبل حتى 5 صور مرجعية في الطلب الواحد، ويدعم إنشاء وتحريرًا حواريًا متعدد الجولات اعتمادًا على السياق السابق، مع نسب أبعاد متعددة ودقات إخراج 1K و2K و4K. يتميز بعرض النصوص متعدد اللغات والطباعة، وتقديم واقعي لملامس البشرة ونسيج الأقمشة والإضاءة المحيطية، وتحرير متسق بالاستناد إلى الصور المرجعية. وفقًا لاختبارات تينسنت الداخلية، تبلغ قدرته الإجمالية نحو 30% أعلى من الجيل السابق، وهو مصمم كنموذج فعّال من حيث التكلفة للإبداع الاحترافي بدلًا من أن يكون متصدرًا في درجات التقييم القياسية، مع فهم قوي للدلالات الصينية وأسلوب واقعي يلائم التسليم التجاري.
يصلح هذا النموذج لمهام الإبداع البصري التجاري: إعلانات وملصقات تجارية ومواد للتجارة الإلكترونية، ورسوم بيانية ومعلوماتية وبطاقات معرفية، وتصميم واجهات المستخدم، وتحرير الصور وتحسين البورتريه، ولوحات قصص الحلقات ومواد الأفلام والتلفزيون، والرسم الإبداعي والهوية البصرية للعلامات. كما يمكن استخدامه عبر واجهة برمجة التطبيقات بمعرّف hy-image-v3.5-preview، إذ تعتمد الواجهة بروتوكول Chat/Messages مع إدخال متعدد الصور وسياق تحرير متعدد الجولات وإعادة صياغة بسلسلة التفكير. يتوفر أيضًا في Tencent Yuanbao وima، ومدمج في منصة Tencent Cloud ADP، ومتاح عبر عقد شركاء في ComfyUI لتوليد الصور وتحريرها.
بصفته إصدار معاينة وليس نسخة نهائية مستقرة، قد يتغير سلوكه وحدوده وأسعاره. يستغرق التوليد زمنًا وسيطًا نحو 15.5 ثانية، وتستغرق صورة مربعة بدقة 2K نحو 20 ثانية، بينما يستغرق التحرير نحو 23 ثانية. قد يؤدي الاختيار التلقائي للحجم إلى اتجاهات مختلفة بين التشغيلات، لذا يُنصح بضبط الحجم يدويًا في بيئات الإنتاج، كما أن تسعير دقة 4K واستقرارها غير واضحين في مرحلة المعاينة.
آخر تحديث:
MODEL ID
hy-image-v3.5-preview- الإدخال
- text / image
- الإخراج
- image
أبرز الميزات
- إدخال نصي وصوري وإخراج صور
- حتى 5 صور مرجعية لكل طلب
- تحرير حواري متعدد الجولات
- دقات إخراج 1K و2K و4K
- عرض نصوص متعدد اللغات
- تقديم واقعي لملامس البشرة
المزوّدون
قارن أسعار API بين المزوّدين. اختر مزوّدًا لعرض جميع الرسوم والشروط.
| التوافر | |
|---|---|
الإحصاءات التاريخية ليست فحصًا مباشرًا للحالة. غياب البيانات لا يعني انقطاع الخدمة.
البدء السريع
أرسل مهمة صورة، ثم استعلم عن حالتها واحفظ الصور. تستخدم الأمثلة curl ومكتبة Python 3 القياسية فقط.
POST https://openapi.felo.ai/api/v1/images/generations
1احصل على مفتاح API
أنشئ مفتاحًا من حسابك على Felo API Platform وعيّنه كمتغير بيئة.
export FELO_API_KEY="YOUR_API_KEY"2أرسل طلبك الأول
تختلف القيم الاختيارية حسب النموذج ولا تُضبط هنا. تحقق منها في Playground. توضع الحقول بجانب model وprompt دون تغليفها داخل input.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "hy-image-v3.5-preview"
}'3الاستعلام عن المهمة
يعيد الإرسال task_id. استعلم كل 3 ثوانٍ أثناء queued أو running، وتوقف عند succeeded أو failed أو interrupted. الحد الأقصى للانتظار 30 دقيقة. احتفظ بملف created.json لاستئناف الاستعلام دون إعادة الإرسال.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4تنزيل الإخراج
بعد النجاح، احفظ outputs من task.json. تُدعم روابط HTTPS وكائنات URL وb64_json. نزّل الروابط الموقعة سريعًا؛ تنزيل الصور لا يحتاج إلى مفتاح API.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
لتعديل الصور، استبدل الرابط التجريبي برابط صورتك HTTPS أو data URL لصورة base64. أرسل مرة واحدة ثم اتبع خطوات الاستعلام والحفظ نفسها.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "hy-image-v3.5-preview",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'المعاملات المدعومة
- n
- seed
- size
- resolution
- aspect_ratio
- input_references
تفضّل المرجع الكامل؟
مرجع API →الأسئلة الشائعة
ما هو Hy Image 3.5 Preview?
يُعد Hy Image 3.5 Preview إصدار معاينة من تينسنت لتوليد الصور وتحريرها، يجمع بين إدخال النص وإدخال الصور وإخراج الصور. يقبل حتى 5 صور مرجعية في الطلب الواحد، ويدعم إنشاء وتحريرًا حواريًا متعدد الجولات اعتمادًا على السياق السابق، مع نسب أبعاد متعددة ودقات إخراج 1K و2K و4K. يتميز بعرض النصوص متعدد اللغات والطباعة، وتقديم واقعي لملامس البشرة ونسيج الأقمشة والإضاءة المحيطية، وتحرير متسق بالاستناد إلى الصور المرجعية. وفقًا لاختبارات تينسنت الداخلية، تبلغ قدرته الإجمالية نحو 30% أعلى من الجيل السابق، وهو مصمم كنموذج فعّال من حيث التكلفة للإبداع الاحترافي بدلًا من أن يكون متصدرًا في درجات التقييم القياسية، مع فهم قوي للدلالات الصينية وأسلوب واقعي يلائم التسليم التجاري. يصلح هذا النموذج لمهام الإبداع البصري التجاري: إعلانات وملصقات تجارية ومواد للتجارة الإلكترونية، ورسوم بيانية ومعلوماتية وبطاقات معرفية، وتصميم واجهات المستخدم، وتحرير الصور وتحسين البورتريه، ولوحات قصص الحلقات ومواد الأفلام والتلفزيون، والرسم الإبداعي والهوية البصرية للعلامات. كما يمكن استخدامه عبر واجهة برمجة التطبيقات بمعرّف hy-image-v3.5-preview، إذ تعتمد الواجهة بروتوكول Chat/Messages مع إدخال متعدد الصور وسياق تحرير متعدد الجولات وإعادة صياغة بسلسلة التفكير. يتوفر أيضًا في Tencent Yuanbao وima، ومدمج في منصة Tencent Cloud ADP، ومتاح عبر عقد شركاء في ComfyUI لتوليد الصور وتحريرها. بصفته إصدار معاينة وليس نسخة نهائية مستقرة، قد يتغير سلوكه وحدوده وأسعاره. يستغرق التوليد زمنًا وسيطًا نحو 15.5 ثانية، وتستغرق صورة مربعة بدقة 2K نحو 20 ثانية، بينما يستغرق التحرير نحو 23 ثانية. قد يؤدي الاختيار التلقائي للحجم إلى اتجاهات مختلفة بين التشغيلات، لذا يُنصح بضبط الحجم يدويًا في بيئات الإنتاج، كما أن تسعير دقة 4K واستقرارها غير واضحين في مرحلة المعاينة.
كيف تُحتسب فاتورة الاستخدام؟
تعتمد فاتورتك على المزوّد الذي تستخدمه وأسعاره واستخدامك. قد تختلف الأسعار مع المدخلات الأطول أو الشروط الأخرى.
ما أنواع المدخلات والمخرجات التي يدعمها النموذج؟
يدعم إدخال النص وإدخال الصور معًا، ويُخرج الصور. يمكنه توليد الصور من النص وتحرير الصور، ويقبل حتى 5 صور مرجعية في الطلب الواحد.
ما الدقات ونسب الأبعاد المتاحة للإخراج؟
يدعم نسب أبعاد متعددة، ودقات إخراج 1K و2K و4K. يُنصح بضبط الحجم يدويًا في الإنتاج لأن الاختيار التلقائي قد ينتج اتجاهات مختلفة بين التشغيلات.
هل يدعم التحرير الحواري متعدد الجولات؟
نعم، يدعم الإنشاء والتحرير الحواريين متعدد الجولات اعتمادًا على السياق السابق، مع إعادة صياغة بسلسلة التفكير عبر بروتوكول Chat/Messages.
كيف يختلف عن الجيل السابق من سلسلة Hy Image؟
وفقًا لاختبارات تينسنت الداخلية، تبلغ قدرته الإجمالية نحو 30% أعلى من الجيل السابق، وهو موجه للإبداع الاحترافي الفعّال من حيث التكلفة.
ما أبرز مهامه المناسبة؟
يلائم الإعلانات والرسوم المعلوماتية وتصميم واجهات المستخدم وتحرير الصور وتحسين البورتريه والبطاقات المعرفية والملصقات التجارية ومواد التجارة الإلكترونية.