Мазмұнға өту

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-та жасалған

Doitong қауымдастығы Flux 3 Action арқылы жасаған жария жұмыстары. Промптты бір рет басу арқылы қайта пайдаланыңыз.

Көрсетілген жария жұмыстар: 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

Эйлер денойзингі қадамдарының саны; бақылау нүктесін тексеруде 4 қадам қолданылған.

әдепкі 3

Бейне мен әрекетке арналған classifier-free guidance күші; CFG функциясын өшіру үшін 1.0 мәнін орнатыңыз.

DROID үшін 0 және SO-101 үшін 42 болатын сілтемелік бағалау параметрлеріндегі үлгілеу тұқымы. Көрсетілмесе, тұқым кездейсоқ таңдалады.

Өлшенген күй тарихы; жаңа эпизодта көрсетілмейді, ал басқа жағдайда `command_history` қажет. `state` параметрінің алдындағы 7 басқару қадамына арналған өлшемдерді хронологиялық ретпен, 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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Flux 3 Action туралы

Медиа орнына болжанған `actions` әрекеттері, олардың басқару жиілігі, баған белгілері және жаңа топтама сұралғанға дейін орындалатын бастапқы қадамдар саны (`execute_steps`) бар JSON қайтарады. Міндетті кірістер: мәтіндік `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` қажет. `state` параметрінің алдындағы 7 басқару қадамына арналған өлшемдерді хронологиялық ретпен, 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
Эйлер денойзингі қадамдарының саны; бақылау нүктесін тексеруде 4 қадам қолданылған.
guidance_scaleміндетті емес
Түріnumber
Әдепкі3
1 – 10
Бейне мен әрекетке арналған classifier-free guidance күші; CFG функциясын өшіру үшін 1.0 мәнін орнатыңыз.
seedміндетті емес
Түріinteger | null
DROID үшін 0 және SO-101 үшін 42 болатын сілтемелік бағалау параметрлеріндегі үлгілеу тұқымы. Көрсетілмесе, тұқым кездейсоқ таңдалады.
міндетті

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
actions
array of array of numberБасқару қадамдарын білдіретін хронологиялық жолдары бар болжанған әрекеттер массиві; мәндер шектелмеген, сондықтан роботта буын, жылдамдық және жұмыс кеңістігі шектерін сақтау қажет. 30 Hz жиілігінде SO-101 deg өлшемінде 42x6 абсолютті команда және қысқыш % береді; 15 Hz жиілігінде DROID rad өлшемінде 32x8 абсолютті буын нысанын және қысқыштың жабық үлесін береді.
action_labels
array of stringӘрекет бағандарына сәйкес келетін атаулар.
action_hz
numberӘрекет жолдарының басқару жиілігі.
execute_steps
integerКелесі бөлікті сұрамас бұрын орындалатын бастапқы әрекеттер саны.
seed
integerҮлгілеу кезінде қолданылатын кездейсоқ тұқым.
timings
objectСерверден алынған, секундпен көрсетілген уақыт өлшемдері.

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/flux-3-action/so101.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt