Lompat ke konten

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 di halaman ini

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

Model kebijakan robot yang memprediksi potongan aksi lengan SO-101 dari bingkai kamera, status sambungan, dan instruksi

Dibuat di Doitong

Karya publik yang dibuat dengan Flux 3 Action oleh komunitas Doitong. Gunakan kembali prompt dengan satu klik.

Karya publik yang ditampilkan: 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...

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib 88 / 2000

Instruksi tugas robot yang dinyatakan dalam bahasa alami.

•wajib
Jatuhkan file, atau

Gambar tile kiri yang menampilkan bingkai saat ini dari kamera adegan tetap setelah diubah ukurannya menjadi 256x256.

•wajib
Jatuhkan file, atau

Bingkai kamera pergelangan tangan saat ini, ditempatkan di tile kanan dan diubah ukurannya menjadi 256x256.

•wajib

Nilai keadaan terukur secara berurutan: pan dan lift bahu, fleksi siku, fleksi dan roll pergelangan tangan, semuanya dalam derajat, diikuti posisi gripper sebagai persentase.

Lanjutan history_scene_image_url · history_wrist_image_url · num_inference_steps · guidance_scale · seed · state_history · command_history
Jatuhkan file, atau

Input bingkai adegan historis yang memerlukan `state_history`; jika dihilangkan, bingkai saat ini akan digunakan. Bingkai yang diberikan mewakili observasi riwayat paling awal, 7 tick sebelumnya.

Jatuhkan file, atau

Bingkai kamera pergelangan tangan pada tick riwayat paling awal; `state_history` wajib diisi.

bawaan 4

Jumlah langkah denoising Euler; validasi checkpoint menggunakan 4 langkah.

bawaan 3

Kekuatan classifier-free guidance untuk video dan aksi; tetapkan ke 1.0 untuk menonaktifkan CFG.

Seed sampling dengan pengaturan evaluasi referensi DROID: 0 dan SO-101: 42. Jika tidak ditentukan, seed dipilih secara acak.

Riwayat keadaan terukur, dihilangkan untuk episode baru dan jika tidak memerlukan `command_history`. Masukkan pengukuran dalam urutan kronologis untuk 7 tick kontrol yang langsung mendahului `state`, pada 30 Hz.

Riwayat perintah absolut yang memerlukan `state_history`, dengan perintah yang terakhir dikirim berada di baris terakhir. Baris berjalan secara kronologis melintasi 8 tick observasi dan menentukan perintah yang berlaku pada setiap tick.

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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Flux 3 Action

Alih-alih media, model ini mengembalikan JSON dengan `actions` yang diprediksi, laju kontrolnya, label kolom, dan jumlah langkah awal yang harus dijalankan (`execute_steps`) sebelum meminta potongan baru. Input wajib adalah `prompt` teks (hingga 2000 karakter), `scene_image_url`, `wrist_image_url`, dan `state` berisi 6 nilai. Input riwayat opsional (`state_history`, `command_history`, gambar riwayat) memberikan konteks temporal. `num_inference_steps` berada pada rentang 1 hingga 8 dan `guidance_scale` dari 1 hingga 10.

Parameter

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
≤ 2.000 karakter
Instruksi tugas robot yang dinyatakan dalam bahasa alami.
scene_image_urlwajib
Tipeurl · image
Gambar tile kiri yang menampilkan bingkai saat ini dari kamera adegan tetap setelah diubah ukurannya menjadi 256x256.
wrist_image_urlwajib
Tipeurl · image
Bingkai kamera pergelangan tangan saat ini, ditempatkan di tile kanan dan diubah ukurannya menjadi 256x256.
statewajib
Tipenumber[]
≤ 6 item≥ 6 item
Nilai keadaan terukur secara berurutan: pan dan lift bahu, fleksi siku, fleksi dan roll pergelangan tangan, semuanya dalam derajat, diikuti posisi gripper sebagai persentase.
state_historyopsional
Tipearray[]
≤ 7 item≥ 7 item
Riwayat keadaan terukur, dihilangkan untuk episode baru dan jika tidak memerlukan `command_history`. Masukkan pengukuran dalam urutan kronologis untuk 7 tick kontrol yang langsung mendahului `state`, pada 30 Hz.
command_historyopsional
Tipearray[]
≤ 8 item≥ 8 item
Riwayat perintah absolut yang memerlukan `state_history`, dengan perintah yang terakhir dikirim berada di baris terakhir. Baris berjalan secara kronologis melintasi 8 tick observasi dan menentukan perintah yang berlaku pada setiap tick.
history_scene_image_urlopsional
Tipeurl · image
Input bingkai adegan historis yang memerlukan `state_history`; jika dihilangkan, bingkai saat ini akan digunakan. Bingkai yang diberikan mewakili observasi riwayat paling awal, 7 tick sebelumnya.
history_wrist_image_urlopsional
Tipeurl · image
Bingkai kamera pergelangan tangan pada tick riwayat paling awal; `state_history` wajib diisi.
num_inference_stepsopsional
Tipeinteger
Bawaan4
1 – 8
Jumlah langkah denoising Euler; validasi checkpoint menggunakan 4 langkah.
guidance_scaleopsional
Tipenumber
Bawaan3
1 – 10
Kekuatan classifier-free guidance untuk video dan aksi; tetapkan ke 1.0 untuk menonaktifkan CFG.
seedopsional
Tipeinteger | null
Seed sampling dengan pengaturan evaluasi referensi DROID: 0 dan SO-101: 42. Jika tidak ditentukan, seed dipilih secara acak.
wajib

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
actions
array of array of numberArray aksi yang diprediksi dengan baris kronologis yang mewakili langkah kontrol; nilainya tidak dipotong, sehingga batas sambungan, kecepatan, dan ruang kerja harus diterapkan pada robot. Pada 30 Hz, SO-101 menyediakan perintah absolut 42x6 dalam derajat dan % gripper; pada 15 Hz, DROID menyediakan target sambungan absolut 32x8 dalam radian ditambah fraksi penutupan gripper.
action_labels
array of stringNama yang sesuai dengan kolom aksi.
action_hz
numberFrekuensi kontrol untuk baris aksi.
execute_steps
integerJumlah aksi awal yang dijalankan sebelum meminta chunk lain.
seed
integerSeed acak yang digunakan selama sampling.
timings
objectPengukuran waktu dari server, dinyatakan dalam detik.

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