Мазмұнға өту

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://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрау: ≈0,003 $ 3 API кредиті Осы бетте іске қосу

API кілтін алу
Black Forest Labs Бейнеден бейнеге #robotic#arm

Камера кадрлары, буын күйі және нұсқау бойынша SO-101 манипуляторының әрекет топтамаларын болжайтын робот саясаты моделі

Black Forest Labs · Деректер (JSON)

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті 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://vit.doitong.com/api/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://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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