Ruka hadi kwenye maudhui
Kiswahili
Pata ufunguo wa API

Flux 3 Action

Unganisha

Kitambulisho cha modeli 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"

Ombi hili: ≈$ 0.003 salio za API 3 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Black Forest Labs Video hadi Video #robotic#arm

Muundo wa sera ya roboti unaotabiri mafungu ya vitendo vya mkono wa SO-101 kutoka fremu za kamera, hali ya viungio na maagizo

OpenAPI Markdown

Imetengenezwa kwenye Doitong

Kazi za umma zilizotengenezwa kwa Flux 3 Action na jumuiya ya Doitong. Tumia tena kidokezo kwa kubofya mara moja.

Kazi za umma zilizoonyeshwa: 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...

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika 88 / 2000

Maelekezo ya kazi ya roboti yaliyoandikwa kwa lugha asilia.

•inahitajika
Dondosha faili, au

Picha ya kigae cha kushoto inayoonyesha fremu ya sasa ya kamera ya tukio lililowekwa, baada ya kubadilishwa ukubwa kuwa 256x256.

•inahitajika
Dondosha faili, au

Fremu ya sasa ya kamera ya kifundo cha mkono, iliyowekwa kwenye kigae cha kulia na kubadilishwa ukubwa kuwa 256x256.

•inahitajika

Thamani za hali zilizopimwa kwa mpangilio: mzunguko na unyanyuaji wa bega, kunyumbulika kwa kiwiko, kunyumbulika na kuzunguka kwa kifundo cha mkono, zote kwa digrii, zikifuatiwa na nafasi ya gripper kama asilimia.

Ya kina history_scene_image_url · history_wrist_image_url · num_inference_steps · guidance_scale · seed · state_history · command_history
Dondosha faili, au

Ingizo la fremu ya tukio la kihistoria linalohitaji `state_history`; likiachwa, fremu ya sasa hutumika badala yake. Fremu iliyotolewa inawakilisha uchunguzi wa mwanzo kabisa wa historia, tiki 7 zilizopita.

Dondosha faili, au

Fremu ya kamera ya kifundo cha mkono katika tiki ya mwanzo kabisa ya historia; `state_history` inahitajika.

chaguomsingi 4

Idadi ya hatua za kuondoa kelele za Euler; uthibitishaji wa checkpoint ulitumia hatua 4.

chaguomsingi 3

Nguvu ya mwongozo usio wa kitaainishaji kwa video na kitendo; iweke kuwa 1.0 ili kuzima CFG.

Mbegu ya usampulishaji yenye mipangilio ya tathmini ya marejeo ya DROID: 0 na SO-101: 42. Usipoibainisha, mbegu huchaguliwa kwa nasibu.

Historia ya hali iliyopimwa, huachwa kwa episode mpya na vinginevyo huhitaji `command_history`. Wasilisha vipimo kwa mpangilio wa wakati kwa tiki 7 za udhibiti zilizotangulia `state`, kwa 30 Hz.

Historia ya amri kamili inayohitaji `state_history`, huku amri iliyotumwa hivi karibuni ikiwa kwenye safu ya mwisho. Safu zinafuata mpangilio wa wakati katika tiki 8 za uchunguzi na kubainisha amri inayotumika kwenye kila tiki.

POST /run/flux-3-action/so101?wait=20 makadirio → $ 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"

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Flux 3 Action

Badala ya midia, hurudisha JSON yenye `actions` zilizotabiriwa, kasi yake ya udhibiti, lebo za safu, na idadi ya hatua za mwanzo za kutekeleza (`execute_steps`) kabla ya kuomba fungu jipya. Ingizo zinazohitajika ni `prompt` ya maandishi (hadi herufi 2000), `scene_image_url`, `wrist_image_url`, na `state` yenye thamani 6. Ingizo za hiari za historia (`state_history`, `command_history`, picha za historia) hutoa muktadha wa muda. `num_inference_steps` huanzia 1 hadi 8 na `guidance_scale` huanzia 1 hadi 10.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
promptinahitajika
Ainastring
≤ herufi 2,000
Maelekezo ya kazi ya roboti yaliyoandikwa kwa lugha asilia.
scene_image_urlinahitajika
Ainaurl · image
Picha ya kigae cha kushoto inayoonyesha fremu ya sasa ya kamera ya tukio lililowekwa, baada ya kubadilishwa ukubwa kuwa 256x256.
wrist_image_urlinahitajika
Ainaurl · image
Fremu ya sasa ya kamera ya kifundo cha mkono, iliyowekwa kwenye kigae cha kulia na kubadilishwa ukubwa kuwa 256x256.
stateinahitajika
Ainanumber[]
≤ vipengee 6≥ vipengee 6
Thamani za hali zilizopimwa kwa mpangilio: mzunguko na unyanyuaji wa bega, kunyumbulika kwa kiwiko, kunyumbulika na kuzunguka kwa kifundo cha mkono, zote kwa digrii, zikifuatiwa na nafasi ya gripper kama asilimia.
state_historysi lazima
Ainaarray[]
≤ vipengee 7≥ vipengee 7
Historia ya hali iliyopimwa, huachwa kwa episode mpya na vinginevyo huhitaji `command_history`. Wasilisha vipimo kwa mpangilio wa wakati kwa tiki 7 za udhibiti zilizotangulia `state`, kwa 30 Hz.
command_historysi lazima
Ainaarray[]
≤ vipengee 8≥ vipengee 8
Historia ya amri kamili inayohitaji `state_history`, huku amri iliyotumwa hivi karibuni ikiwa kwenye safu ya mwisho. Safu zinafuata mpangilio wa wakati katika tiki 8 za uchunguzi na kubainisha amri inayotumika kwenye kila tiki.
history_scene_image_urlsi lazima
Ainaurl · image
Ingizo la fremu ya tukio la kihistoria linalohitaji `state_history`; likiachwa, fremu ya sasa hutumika badala yake. Fremu iliyotolewa inawakilisha uchunguzi wa mwanzo kabisa wa historia, tiki 7 zilizopita.
history_wrist_image_urlsi lazima
Ainaurl · image
Fremu ya kamera ya kifundo cha mkono katika tiki ya mwanzo kabisa ya historia; `state_history` inahitajika.
num_inference_stepssi lazima
Ainainteger
Chaguomsingi4
1 – 8
Idadi ya hatua za kuondoa kelele za Euler; uthibitishaji wa checkpoint ulitumia hatua 4.
guidance_scalesi lazima
Ainanumber
Chaguomsingi3
1 – 10
Nguvu ya mwongozo usio wa kitaainishaji kwa video na kitendo; iweke kuwa 1.0 ili kuzima CFG.
seedsi lazima
Ainainteger | null
Mbegu ya usampulishaji yenye mipangilio ya tathmini ya marejeo ya DROID: 0 na SO-101: 42. Usipoibainisha, mbegu huchaguliwa kwa nasibu.
inahitajika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
actions
array of array of numberSafu ya vitendo vilivyotabiriwa yenye safu za mpangilio wa wakati zinazowakilisha hatua za udhibiti; thamani hazijakatwa, hivyo vikomo vya viungo, kasi na eneo la kazi lazima vitekelezwe kwenye roboti. Kwa 30 Hz, SO-101 hutoa amri kamili 42x6 kwa deg na gripper %; kwa 15 Hz, DROID hutoa malengo kamili 32x8 ya viungo kwa rad pamoja na sehemu iliyofungwa ya gripper.
action_labels
array of stringMajina yanayolingana na safu za vitendo.
action_hz
numberMasafa ya udhibiti ya safu za vitendo.
execute_steps
integerIdadi ya vitendo vya mwanzo vya kutekeleza kabla ya kuomba kipande kingine.
seed
integerMbegu ya nasibu iliyotumika wakati wa usampulishaji.
timings
objectVipimo vya muda kutoka kwa seva, vilivyoonyeshwa kwa sekunde.
Video
Black Forest Labs Video hadi Video

Flux 3 Extend Video Tofauti: 6

kuanzia $ 0.41 / sekunde salio za API 410 / sekunde 5 s ≈ $ 2.05
Video
Black Forest Labs Video hadi Video

Flux 3 FAST Edit Video

$ 0.03 / sekunde ya video ya ingizo salio za API 30 / sekunde ya video ya ingizo

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/flux-3-action/so101.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt