שפּרינגען צו אינהאַלט

Flux 3 Action

אינטעגרירן

מאָדעל־id 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

Classifier-free guidance־שטאַרקייט פֿאַר ווידעא און אַקציע; שטעלן צו 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Flux 3 Action

אַנשטאָט מעדיע גיט דאָס צוריק JSON מיט פֿאָרויסגעזאָגטע `actions`, זייער קאָנטראָל־קורס, זייַל־לאַבעלן, און וויפֿל פֿאָרויסגייענדיקע שריט אויסצופירן (`execute_steps`) איידער מען בעט אַ נײַעם פּעקל. פארלאנגטע אַרייַנשריפטן זענען אַ טעקסט־`prompt` (ביז 2000 אותיות), `scene_image_url`, `wrist_image_url`, און אַ 6־ווערטיקער `state`. אָפּטיאָנאַלע היסטאָריע־אַרייַנשריפטן (`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
Classifier-free guidance־שטאַרקייט פֿאַר ווידעא און אַקציע; שטעלן צו 1.0 צו דיסייבלען CFG.
seedאָפּציאָנעל
טיפּinteger | null
סאַמפּלינג־סיד מיט DROID־רעפֿערענץ־עוואַלואַציע־סעטינגס: 0 און SO-101: 42. אויב עס ווערט נישט ספּעציפיצירט, ווערט אַ סיד אויסגעקליבן צופֿעליק.
פארלאנגט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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 אַבסאָלוטע קאָמאַנדעס אין deg און גריפּער־%; ביי 15 Hz גיט DROID 32x8 אַבסאָלוטע דזשוינט־צילן אין rad פּלוס דעם פארמאכטן פּראָצענט פֿון דער גריפּער.
action_labels
array of stringנעמען וואָס שטימען צו די אַקציע־קאָלומס.
action_hz
numberקאָנטראָל־פֿרעקווענץ פֿאַר די אַקציע־רייען.
execute_steps
integerצאָל ערשטע אַקציעס צו דורכפירן איידער מען בעט נאָך אַ פּעקל.
seed
integerצופֿעליקער סיד וואָס ווערט גענוצט בעת סאַמפּלינג.
timings
objectצײַט־מעסונגען פֿון סערווער, אויסגעדריקט אין סעקונדעס.

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/flux-3-action/so101.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt