Preskoči na vsebino

Flux 3 Action

Integracija

ID modela 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"

Ta zahteva: ≈0,003 $ 3 API krediti Zaženi na tej strani

Pridobi ključ API
Black Forest Labs Videoposnetek v videoposnetek #robotic#arm

Model politike robota, ki iz okvirjev kamere, stanja sklepov in navodila napoveduje sklope dejanj roke SO-101

Black Forest Labs · Podatki (JSON)

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno 88 / 2000

Navodila za robotsko opravilo, zapisana v naravnem jeziku.

•obvezno
Spustite datoteko ali

Slika leve ploščice, ki po spremembi velikosti na 256x256 prikazuje trenutni kader kamere fiksnega prizora.

•obvezno
Spustite datoteko ali

Trenutni kader kamere zapestja, postavljen v desno ploščico in spremenjen na 256x256.

•obvezno

Izmerjene vrednosti stanja po vrstnem redu: zasuk in dvig rame, upogib komolca, upogib in zasuk zapestja, vse v stopinjah, nato položaj prijemala v odstotkih.

Napredno history_scene_image_url · history_wrist_image_url · num_inference_steps · guidance_scale · seed · state_history · command_history
Spustite datoteko ali

Vhod zgodovinskega kadra prizora, ki zahteva `state_history`; če je izpuščen, se uporabi trenutni kader. Podani kader predstavlja najzgodnejše opazovanje v zgodovini, 7 taktov nazaj.

Spustite datoteko ali

Kader kamere zapestja ob najzgodnejšem zgodovinskem taktu; `state_history` je zahtevan.

privzeto 4

Število korakov odstranjevanja šuma Euler; preverjanje kontrolne točke je uporabilo 4 korake.

privzeto 3

Moč klasifikatorju prostega vodenja za video in dejanje; nastavi na 1.0, da onemogočiš CFG.

Seme vzorčenja z referenčnimi nastavitvami vrednotenja DROID: 0 in SO-101: 42. Če ga ne navedeš, se seme izbere naključno.

Zgodovina izmerjenega stanja, izpuščena pri novi epizodi, sicer pa zahteva `command_history`. Meritve podaj kronološko za 7 krmilnih taktov neposredno pred `state`, pri 30 Hz.

Zgodovina absolutnih ukazov, ki zahteva `state_history`, pri čemer je nazadnje poslani ukaz v zadnji vrstici. Vrstice potekajo kronološko čez 8 opazovalnih taktov in določajo ukaz, veljaven v posameznem taktu.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Flux 3 Action

Namesto predstavnostnih podatkov vrne JSON z napovedanimi `actions`, njihovo frekvenco upravljanja, oznakami stolpcev in številom začetnih korakov, ki jih je treba izvesti (`execute_steps`), preden se zahteva nov sklop. Obvezni vhodi so besedilni `prompt` (do 2000 znakov), `scene_image_url`, `wrist_image_url` in `state` s 6 vrednostmi. Neobvezni zgodovinski vhodi (`state_history`, `command_history`, zgodovinske slike) zagotavljajo časovni kontekst. `num_inference_steps` se giblje od 1 do 8, `guidance_scale` pa od 1 do 10.

Parametri

ImeVrsta PrivzetoDovoljeno Opis
promptobvezno
Vrstastring
≤ 2000 znakov
Navodila za robotsko opravilo, zapisana v naravnem jeziku.
scene_image_urlobvezno
Vrstaurl · image
Slika leve ploščice, ki po spremembi velikosti na 256x256 prikazuje trenutni kader kamere fiksnega prizora.
wrist_image_urlobvezno
Vrstaurl · image
Trenutni kader kamere zapestja, postavljen v desno ploščico in spremenjen na 256x256.
stateobvezno
Vrstanumber[]
≤ 6 elementov≥ 6 elementov
Izmerjene vrednosti stanja po vrstnem redu: zasuk in dvig rame, upogib komolca, upogib in zasuk zapestja, vse v stopinjah, nato položaj prijemala v odstotkih.
state_historyneobvezno
Vrstaarray[]
≤ 7 elementov≥ 7 elementov
Zgodovina izmerjenega stanja, izpuščena pri novi epizodi, sicer pa zahteva `command_history`. Meritve podaj kronološko za 7 krmilnih taktov neposredno pred `state`, pri 30 Hz.
command_historyneobvezno
Vrstaarray[]
≤ 8 elementov≥ 8 elementov
Zgodovina absolutnih ukazov, ki zahteva `state_history`, pri čemer je nazadnje poslani ukaz v zadnji vrstici. Vrstice potekajo kronološko čez 8 opazovalnih taktov in določajo ukaz, veljaven v posameznem taktu.
history_scene_image_urlneobvezno
Vrstaurl · image
Vhod zgodovinskega kadra prizora, ki zahteva `state_history`; če je izpuščen, se uporabi trenutni kader. Podani kader predstavlja najzgodnejše opazovanje v zgodovini, 7 taktov nazaj.
history_wrist_image_urlneobvezno
Vrstaurl · image
Kader kamere zapestja ob najzgodnejšem zgodovinskem taktu; `state_history` je zahtevan.
num_inference_stepsneobvezno
Vrstainteger
Privzeto4
1 – 8
Število korakov odstranjevanja šuma Euler; preverjanje kontrolne točke je uporabilo 4 korake.
guidance_scaleneobvezno
Vrstanumber
Privzeto3
1 – 10
Moč klasifikatorju prostega vodenja za video in dejanje; nastavi na 1.0, da onemogočiš CFG.
seedneobvezno
Vrstainteger | null
Seme vzorčenja z referenčnimi nastavitvami vrednotenja DROID: 0 in SO-101: 42. Če ga ne navedeš, se seme izbere naključno.
obvezno

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
actions
array of array of numberNapovedano polje dejanj s kronološkimi vrsticami, ki predstavljajo krmilne korake; vrednosti niso omejene, zato je treba omejitve sklepov, hitrosti in delovnega prostora uveljaviti na robotu. Pri 30 Hz SO-101 zagotavlja 42x6 absolutnih ukazov v stopinjah in % prijemala; pri 15 Hz DROID zagotavlja 32x8 absolutnih ciljnih vrednosti sklepov v radianih in delež zaprtosti prijemala.
action_labels
array of stringImena, ki ustrezajo stolpcem dejanj.
action_hz
numberKrmilna frekvenca vrstic dejanj.
execute_steps
integerŠtevilo začetnih dejanj, ki se izvedejo, preden se zahteva nov sklop.
seed
integerNaključno seme, uporabljeno pri vzorčenju.
timings
objectČasovne meritve strežnika, izražene v sekundah.

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/flux-3-action/so101.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt