דילוג לתוכן

Flux 3 Action

שילוב

מזהה מודל flux-3-action/so101
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/flux-3-action/so101?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",
    "scene_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "wrist_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "state": [
      -18.94,
      134.52,
      120.15,
      28.3,
      -32.17,
      27.02
    ]
  }'

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

בקשה זו: ≈⁨‏0.003 ‏$⁩ 3 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Black Forest Labs ווידאו לווידאו #robotic#arm

מודל מדיניות רובוטית החוזה מקטעי פעולה של זרוע SO-101 מתוך פריימים מהמצלמה, מצב המפרקים והוראה

נוצר ב-Doitong

יצירות ציבוריות שנוצרו עם Flux 3 Action על ידי קהילת Doitong. אפשר להשתמש מחדש בפרומפט בלחיצה אחת.

יצירות ציבוריות שמוצגות: 9
Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut ...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikel...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi wajahnya. Ia memeluk...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tub...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tubuh ramping dan proporsional, rambut hitam pendek agak acak, mengenakan jaket kulit hitam, celana riding fit, dan sepatu motor. Ia sedang melakukan aksi freestyle ekstrem dengan motor sport 500cc...

בנה בקשה

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

•חובה 88 / 2000

הוראות למשימת הרובוט המנוסחות בשפה טבעית.

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

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

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

הפריים הנוכחי של מצלמת שורש כף היד, הממוקם באריח הימני ושגודלו שונה ל־256x256.

•חובה

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

מתקדם history_scene_image_url · history_wrist_image_url · num_inference_steps · guidance_scale · seed · state_history · command_history
גרור קובץ, או

קלט פריים היסטורי של הסצנה הדורש `state_history`; השמטה משתמשת בפריים הנוכחי. הפריים שסופק מייצג את תצפית ההיסטוריה המוקדמת ביותר, לפני 7 תקתוקים.

גרור קובץ, או

פריים מצלמת שורש כף היד בתקתק ההיסטוריה המוקדם ביותר; נדרש `state_history`.

ברירת מחדל 4

מספר צעדי הסרת הרעש של Euler; אימות נקודת הבדיקה השתמש ב־4 צעדים.

ברירת מחדל 3

עוצמת ההנחיה ללא מסווג עבור הווידאו והפעולה; יש להגדיר 1.0 כדי להשבית CFG.

זרע הדגימה עם הגדרות הערכת הייחוס של DROID: 0 ושל SO-101: 42. השארת השדה ללא ציון בוחרת זרע באקראי.

היסטוריית המצב שנמדד, מושמטת בפרק חדש ובמקרים אחרים דורשת `command_history`. יש לספק את המדידות בסדר כרונולוגי עבור 7 תקתוקי הבקרה שקדמו מיד ל־`state`, בתדר 30 Hz.

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

POST /run/flux-3-action/so101?wait=20 הצעת מחיר → ⁨‏0.003 ‏$⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/flux-3-action/so101?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",
    "scene_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "wrist_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "state": [
      -18.94,
      134.52,
      120.15,
      28.3,
      -32.17,
      27.02
    ]
  }'

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

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

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

מידע על Flux 3 Action

במקום מדיה, מחזיר JSON עם `actions` חזויים, קצב הבקרה שלהם, תוויות העמודות ומספר הצעדים הראשונים לביצוע (`execute_steps`) לפני בקשת מקטע חדש. הקלטים הנדרשים הם `prompt` טקסטואלי (עד 2000 תווים), `scene_image_url`, `wrist_image_url` ו-`state` בעל 6 ערכים. קלטי היסטוריה אופציונליים (`state_history`, `command_history`, תמונות היסטוריה) מספקים הקשר זמני. `num_inference_steps` נע בין 1 ל-8 ו-`guidance_scale` בין 1 ל-10.

פרמטרים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
≤ 2,000 תווים
הוראות למשימת הרובוט המנוסחות בשפה טבעית.
scene_image_urlחובה
סוגurl · image
תמונת אריח שמאלי המציגה את הפריים הנוכחי של מצלמת הסצנה הקבועה לאחר שינוי גודל ל־256x256.
wrist_image_urlחובה
סוגurl · image
הפריים הנוכחי של מצלמת שורש כף היד, הממוקם באריח הימני ושגודלו שונה ל־256x256.
stateחובה
סוגnumber[]
≤ 6 פריטים≥ 6 פריטים
ערכי מצב שנמדדו לפי הסדר: סיבוב והרמה של הכתף, כפיפת המרפק, כפיפה וסיבוב של שורש כף היד, כולם במעלות, ולאחר מכן מיקום התפס באחוזים.
state_historyאופציונלי
סוגarray[]
≤ 7 פריטים≥ 7 פריטים
היסטוריית המצב שנמדד, מושמטת בפרק חדש ובמקרים אחרים דורשת `command_history`. יש לספק את המדידות בסדר כרונולוגי עבור 7 תקתוקי הבקרה שקדמו מיד ל־`state`, בתדר 30 Hz.
command_historyאופציונלי
סוגarray[]
≤ 8 פריטים≥ 8 פריטים
היסטוריית פקודות מוחלטות הדורשת `state_history`, כאשר הפקודה שנשלחה לאחרונה נמצאת בשורה האחרונה. השורות מסודרות כרונולוגית על פני 8 תקתוקי תצפית ומציינות את הפקודה הפעילה בכל תקתוק.
history_scene_image_urlאופציונלי
סוגurl · image
קלט פריים היסטורי של הסצנה הדורש `state_history`; השמטה משתמשת בפריים הנוכחי. הפריים שסופק מייצג את תצפית ההיסטוריה המוקדמת ביותר, לפני 7 תקתוקים.
history_wrist_image_urlאופציונלי
סוגurl · image
פריים מצלמת שורש כף היד בתקתק ההיסטוריה המוקדם ביותר; נדרש `state_history`.
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל4
1 – 8
מספר צעדי הסרת הרעש של Euler; אימות נקודת הבדיקה השתמש ב־4 צעדים.
guidance_scaleאופציונלי
סוגnumber
ברירת מחדל3
1 – 10
עוצמת ההנחיה ללא מסווג עבור הווידאו והפעולה; יש להגדיר 1.0 כדי להשבית CFG.
seedאופציונלי
סוגinteger | null
זרע הדגימה עם הגדרות הערכת הייחוס של DROID: 0 ושל SO-101: 42. השארת השדה ללא ציון בוחרת זרע באקראי.
חובה

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux-3-action/so101",
  "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": 3,
    "usd": "0.003",
    "charged": 3,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "scene_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "wrist_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "state": [
      -18.94,
      134.52,
      120.15,
      28.3,
      -32.17,
      27.02
    ]
  },
  "output": {
    "actions": [
      [
        1.0
      ]
    ],
    "action_labels": [
      "string"
    ],
    "action_hz": 1.0,
    "execute_steps": 1,
    "seed": 42,
    "timings": {}
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
actions
array of array of numberמערך הפעולות החזויות, עם שורות כרונולוגיות המייצגות צעדי בקרה; הערכים אינם מוגבלים, לכן יש לאכוף על הרובוט מגבלות מפרקים, מהירות ומרחב עבודה. בתדר 30 Hz,‏ SO-101 מספק פקודות מוחלטות בגודל 42x6 במעלות ובאחוזי תפס; בתדר 15 Hz,‏ DROID מספק יעדי מפרקים מוחלטים בגודל 32x8 ברדיאנים, בתוספת השבר הסגור של התפס.
action_labels
array of stringשמות התואמים לעמודות הפעולה.
action_hz
numberתדר הבקרה עבור שורות הפעולה.
execute_steps
integerמספר הפעולות הראשוניות לביצוע לפני בקשת מקטע נוסף.
seed
integerהזרע האקראי המשמש במהלך הדגימה.
timings
objectמדידות תזמון מהשרת, המבוטאות בשניות.

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