דילוג לתוכן

Hunyuan Image · v3 · Text to Image

שילוב

מזהה מודל hunyuan-image/v3/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan-image/v3/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ⁨‏0.10 ‏$⁩ 100 קרדיטי API · ≈ ⁨‏10.73 ‏₽⁩ הרצה בדף הזה

קבלת מפתח API
Tencent טקסט לתמונה #text-to-image

Hunyuan Image 3.0 מטקסט לתמונה עם פרומפט שלילי והנחיה ברירת מחדל גבוהה יותר של 7.5

Tencent · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה

הנחיית טקסט המשמשת ליצירת תמונה מתמונה.

image_size ברירת מחדל square_hd

המידות הרצויות לתמונה שנוצרה.

num_images ברירת מחדל 1

מספר התמונות המבוקש ליצירה.

מתקדם negative_prompt · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · enable_prompt_expansion
ברירת מחדל

מושגים שיש להרתיע את המודל מליצור בתמונה, המסופקים כהנחיה שלילית.

output_format ברירת מחדל png

פורמט הקובץ של התמונה שהתקבלה.

ברירת מחדל 28

מספר צעדי הסרת הרעש לביצוע.

ברירת מחדל 7.5

עוצמת ההיצמדות להנחיה: הגדל ערך זה כדי לגרום למודל לעקוב אחר ההנחיה בקפדנות רבה יותר.

סיד לשחזור; None מאפשר למערכת לבחור ערך אקראי במקום להשתמש בערך שצוין על ידי הקורא.

POST /run/hunyuan-image/v3/text-to-image?wait=20 הצעת מחיר → ⁨‏0.10 ‏$⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan-image/v3/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Hunyuan Image · v3 · Text to Image

יוצר תמונות מ-`prompt` עם `negative_prompt` אופציונלי. ברירת המחדל היא 28 שלבים (מקסימום 50) ו-`guidance_scale` של 7.5. `enable_prompt_expansion` כבוי כברירת מחדל ומשתמש במודל שפה להוספת פרטים כשהוא מופעל. מחזיר 1 עד 4 תמונות בפורמט png או jpeg.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
הנחיית טקסט המשמשת ליצירת תמונה מתמונה.
negative_promptאופציונלי
סוגstring
ברירת מחדל
מושגים שיש להרתיע את המודל מליצור בתמונה, המסופקים כהנחיה שלילית.
image_sizeאופציונלי
סוגobject
ברירת מחדלsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
המידות הרצויות לתמונה שנוצרה.
num_imagesאופציונלי num_outputs
סוגinteger
ברירת מחדל1
1 – 4
מספר התמונות המבוקש ליצירה.
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל28
1 – 50
מספר צעדי הסרת הרעש לביצוע.
guidance_scaleאופציונלי
סוגnumber
ברירת מחדל7.5
1 – 20
עוצמת ההיצמדות להנחיה: הגדל ערך זה כדי לגרום למודל לעקוב אחר ההנחיה בקפדנות רבה יותר.
seedאופציונלי
סוגinteger | null
סיד לשחזור; None מאפשר למערכת לבחור ערך אקראי במקום להשתמש בערך שצוין על ידי הקורא.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
מתג בדיקת בטיחות, שמצב הכיבוי שלו דורש הרשאת חשבון. ללא הרשאה זו, כל בקשה נבדקת ללא קשר להגדרה; true מפעיל את הבודק.
output_formatאופציונלי
סוגenum
ברירת מחדלpng
jpegpng
פורמט הקובץ של התמונה שהתקבלה.
enable_prompt_expansionאופציונלי
סוגboolean
ברירת מחדלfalse
מאפשר למודל שפה גדול להעשיר את ההנחיה בפרטים. הפעלת ההרחבה אינה משנה את משמעות ההנחיה.
חובה שם קנוני, מתקבל גם הוא

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-image/v3/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
images
array of object {url, content_type, file_name, file_size, width, height}רשימה המכילה את התמונות שנוצרו.
seed
integerסיד בסיסי המשמש במהלך היצירה.

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/hunyuan-image/v3/text-to-image.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt