Langkau ke kandungan

Flux 3 Action

Integrasikan

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

Permintaan ini: ≈$0.003 3 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Black Forest Labs Video ke Video #robotic#arm

Model dasar robot yang meramalkan kelompok tindakan lengan SO-101 daripada bingkai kamera, keadaan sendi dan arahan

Dibuat di Doitong

Karya awam yang dibuat dengan Flux 3 Action oleh komuniti Doitong. Guna semula prompt dengan satu klik.

Karya awam dipaparkan: 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...

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan 88 / 2000

Arahan tugas robot yang dinyatakan dalam bahasa semula jadi.

•diperlukan
Lepaskan fail, atau

Imej jubin kiri yang menunjukkan bingkai semasa kamera adegan tetap selepas diubah saiz kepada 256x256.

•diperlukan
Lepaskan fail, atau

Bingkai semasa kamera pergelangan tangan, diletakkan dalam jubin kanan dan diubah saiz kepada 256x256.

•diperlukan

Nilai keadaan yang diukur mengikut urutan: pan dan angkat bahu, lenturan siku, lenturan dan putaran pergelangan tangan, semuanya dalam darjah, diikuti kedudukan pencengkam sebagai peratusan.

Lanjutan history_scene_image_url · history_wrist_image_url · num_inference_steps · guidance_scale · seed · state_history · command_history
Lepaskan fail, atau

Input bingkai adegan sejarah yang memerlukan `state_history`; jika diabaikan, bingkai semasa digunakan. Bingkai yang dibekalkan mewakili pemerhatian sejarah paling awal, 7 detik yang lalu.

Lepaskan fail, atau

Bingkai kamera pergelangan tangan pada detik sejarah paling awal; `state_history` diperlukan.

lalai 4

Bilangan langkah penyahbisingan Euler; pengesahan checkpoint menggunakan 4 langkah.

lalai 3

Kekuatan panduan tanpa pengelas untuk video dan tindakan; tetapkan kepada 1.0 untuk melumpuhkan CFG.

Seed pensampelan dengan tetapan penilaian rujukan DROID: 0 dan SO-101: 42. Jika tidak dinyatakan, seed dipilih secara rawak.

Sejarah keadaan yang diukur, diabaikan untuk episod baharu dan sebaliknya memerlukan `command_history`. Bekalkan ukuran dalam susunan kronologi untuk 7 detik kawalan sejurus sebelum `state`, pada 30 Hz.

Sejarah arahan mutlak yang memerlukan `state_history`, dengan arahan yang paling baru dihantar dalam baris terakhir. Baris disusun mengikut kronologi merentasi 8 detik pemerhatian dan menentukan arahan yang berkuat kuasa pada setiap detik.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Flux 3 Action

Daripada media, model ini mengembalikan JSON dengan `actions` yang diramalkan, kadar kawalannya, label lajur dan bilangan langkah awal untuk dilaksanakan (`execute_steps`) sebelum meminta kelompok baharu. Input yang diperlukan ialah `prompt` teks (sehingga 2000 aksara), `scene_image_url`, `wrist_image_url` dan `state` 6 nilai. Input sejarah pilihan (`state_history`, `command_history`, imej sejarah) memberikan konteks temporal. `num_inference_steps` berjulat dari 1 hingga 8 dan `guidance_scale` dari 1 hingga 10.

Parameter

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 2,000 aksara
Arahan tugas robot yang dinyatakan dalam bahasa semula jadi.
scene_image_urldiperlukan
Jenisurl · image
Imej jubin kiri yang menunjukkan bingkai semasa kamera adegan tetap selepas diubah saiz kepada 256x256.
wrist_image_urldiperlukan
Jenisurl · image
Bingkai semasa kamera pergelangan tangan, diletakkan dalam jubin kanan dan diubah saiz kepada 256x256.
statediperlukan
Jenisnumber[]
≤ 6 item≥ 6 item
Nilai keadaan yang diukur mengikut urutan: pan dan angkat bahu, lenturan siku, lenturan dan putaran pergelangan tangan, semuanya dalam darjah, diikuti kedudukan pencengkam sebagai peratusan.
state_historypilihan
Jenisarray[]
≤ 7 item≥ 7 item
Sejarah keadaan yang diukur, diabaikan untuk episod baharu dan sebaliknya memerlukan `command_history`. Bekalkan ukuran dalam susunan kronologi untuk 7 detik kawalan sejurus sebelum `state`, pada 30 Hz.
command_historypilihan
Jenisarray[]
≤ 8 item≥ 8 item
Sejarah arahan mutlak yang memerlukan `state_history`, dengan arahan yang paling baru dihantar dalam baris terakhir. Baris disusun mengikut kronologi merentasi 8 detik pemerhatian dan menentukan arahan yang berkuat kuasa pada setiap detik.
history_scene_image_urlpilihan
Jenisurl · image
Input bingkai adegan sejarah yang memerlukan `state_history`; jika diabaikan, bingkai semasa digunakan. Bingkai yang dibekalkan mewakili pemerhatian sejarah paling awal, 7 detik yang lalu.
history_wrist_image_urlpilihan
Jenisurl · image
Bingkai kamera pergelangan tangan pada detik sejarah paling awal; `state_history` diperlukan.
num_inference_stepspilihan
Jenisinteger
Lalai4
1 – 8
Bilangan langkah penyahbisingan Euler; pengesahan checkpoint menggunakan 4 langkah.
guidance_scalepilihan
Jenisnumber
Lalai3
1 – 10
Kekuatan panduan tanpa pengelas untuk video dan tindakan; tetapkan kepada 1.0 untuk melumpuhkan CFG.
seedpilihan
Jenisinteger | null
Seed pensampelan dengan tetapan penilaian rujukan DROID: 0 dan SO-101: 42. Jika tidak dinyatakan, seed dipilih secara rawak.
diperlukan

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
actions
array of array of numberTatasusunan tindakan yang diramal dengan baris kronologi yang mewakili langkah kawalan; nilai tidak dipotong, jadi had sendi, halaju dan ruang kerja mesti dikuatkuasakan pada robot. Pada 30 Hz, SO-101 menyediakan arahan mutlak 42x6 dalam darjah dan % pencengkam; pada 15 Hz, DROID menyediakan sasaran sendi mutlak 32x8 dalam rad serta pecahan tertutup pencengkam.
action_labels
array of stringNama yang sepadan dengan lajur tindakan.
action_hz
numberFrekuensi kawalan untuk baris tindakan.
execute_steps
integerBilangan tindakan awal yang perlu dilaksanakan sebelum meminta bahagian seterusnya.
seed
integerSeed rawak yang digunakan semasa pensampelan.
timings
objectUkuran masa daripada pelayan, dinyatakan dalam saat.

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/flux-3-action/so101.md. Semua model dan panduan: https://doitong.com/developers/llms.txt