דילוג לתוכן

Uso

שילוב

מזהה מודל uso
# 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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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.55 ‏₽⁩ הרצה בדף הזה

קבלת מפתח API
ByteDance עריכת תמונה #image-to-image

יצירת תמונות מונחית סגנון ונושא מתמונת תוכן ומתמונה אחת או שתיים של סגנון

ByteDance · תמונה

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

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

בנה בקשה

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

ברירת מחדל

טקסט הנחיית היצירה; השאירו ריק כדי לבצע העברת סגנון בלבד.

•חובה
גרור קובץ, או

רשימת כתובות URL של תמונות בסדר הבא: [content_image, style_image, extra_style_image].

image_size ברירת מחדל square_hd

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

num_images ברירת מחדל 1

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

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

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

output_format ברירת מחדל png

פורמט תמונת הפלט: PNG שומר על שקיפות, ואילו JPEG מפיק קבצים קטנים יותר.

ברירת מחדל 28

מספר איטרציות הסרת הרעש, המאזן בין זמן יצירה ארוך יותר לבין איכות פוטנציאלית טובה יותר ככל שהמספר עולה.

ברירת מחדל 4

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

Seed השולט באקראיות היצירה. שימוש חוזר ב-Seed מפיק תוצאות עקביות וניתנות לשחזור.

POST /run/uso?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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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

מידע על Uso

מקבל את `input_image_urls` בסדר של תמונת תוכן, תמונת סגנון ותמונת סגנון נוספת אופציונלית. ההנחיה יכולה להיות ריקה להעברת סגנון טהורה, ו־`negative_prompt` מחריג רכיבים לא רצויים. `keep_size` שומר על הפריסה והמידות של תמונת התוכן. בכל הרצה מתקבלות 1 עד 4 תמונות, עם 1 עד 50 צעדים ופלט PNG או JPEG.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
promptאופציונלי
סוגstring
ברירת מחדל
טקסט הנחיית היצירה; השאירו ריק כדי לבצע העברת סגנון בלבד.
input_image_urlsחובה
סוגurl[] · image
רשימת כתובות URL של תמונות בסדר הבא: [content_image, style_image, extra_style_image].
image_sizeאופציונלי
סוגobject
ברירת מחדלsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ממדי התמונה שנוצרה.
negative_promptאופציונלי
סוגstring
ברירת מחדל
תוכן תמונה לא רצוי שיש להחריג, כולל אלמנטים, סגנונות וארטיפקטים.
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל28
1 – 50
מספר איטרציות הסרת הרעש, המאזן בין זמן יצירה ארוך יותר לבין איכות פוטנציאלית טובה יותר ככל שהמספר עולה.
guidance_scaleאופציונלי
סוגnumber
ברירת מחדל4
1 – 10
בקרת היצמדות להנחיה: הגדילו ערך זה כדי לגרום לתוצאה לעקוב מקרוב יותר אחר ההנחיה.
keep_sizeאופציונלי
סוגboolean
ברירת מחדלfalse
שמירת הגודל והסידור של תמונת התוכן ללא שינוי בעת העיבוד, אפשרות שימושית להעברת סגנון.
num_imagesאופציונלי num_outputs
סוגinteger
ברירת מחדל1
1 – 4
מספר התמונות שנוצרות במקביל.
seedאופציונלי
סוגinteger | null
Seed השולט באקראיות היצירה. שימוש חוזר ב-Seed מפיק תוצאות עקביות וניתנות לשחזור.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
הפעלת זיהוי וסינון של תוכן NSFW.
output_formatאופציונלי
סוגenum
ברירת מחדלpng
jpegpng
פורמט תמונת הפלט: PNG שומר על שקיפות, ואילו JPEG מפיק קבצים קטנים יותר.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "uso",
  "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": {
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "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ערך Seed המשמש במהלך היצירה.
has_nsfw_concepts
array of booleanתוצאות זיהוי NSFW עבור כל תמונה שנוצרה.
prompt
stringההנחיה ששימשה במהלך היצירה.
timings
objectמדידות זמני ביצוע המחולקות לפי שלב.

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