Μετάβαση στο περιεχόμενο

Flux 3 Action

Ενσωμάτωση

id μοντέλου 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

Δημόσια έργα που δημιουργήθηκαν με το Flux 3 Action από την κοινότητα του Doitong. Επαναχρησιμοποιήστε ένα prompt με ένα κλικ.

Δημόσιες δημιουργίες: 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 ticks πριν.

Αποθέστε ένα αρχείο ή

Καρέ κάμερας καρπού στο παλαιότερο tick του ιστορικού· απαιτείται `state_history`.

προεπιλογή 4

Αριθμός βημάτων αποθορυβοποίησης Euler· η επικύρωση checkpoint χρησιμοποίησε 4 βήματα.

προεπιλογή 3

Ισχύς classifier-free guidance για βίντεο και ενέργεια· ορίστε την σε 1.0 για απενεργοποίηση του CFG.

Seed δειγματοληψίας με ρυθμίσεις αξιολόγησης αναφοράς του DROID: 0 και του SO-101: 42. Αν παραλειφθεί, επιλέγεται τυχαία seed.

Ιστορικό μετρημένης κατάστασης, παραλείπεται για νέο επεισόδιο και διαφορετικά απαιτεί `command_history`. Παρέχετε τις μετρήσεις με χρονολογική σειρά για τα 7 control ticks αμέσως πριν από το `state`, στα 30 Hz.

Ιστορικό απόλυτων εντολών που απαιτεί `state_history`, με την πιο πρόσφατα απεσταλμένη εντολή στην τελευταία γραμμή. Οι γραμμές εκτείνονται χρονολογικά σε 8 ticks παρατήρησης και καθορίζουν την εντολή που ισχύει σε κάθε tick.

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 και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το Flux 3 Action

Αντί για πολυμέσα, επιστρέφει JSON με τις προβλεπόμενες `actions`, τον ρυθμό ελέγχου τους, τις ετικέτες στηλών και πόσα αρχικά βήματα πρέπει να εκτελεστούν (`execute_steps`) πριν ζητηθεί νέο τμήμα. Απαιτούμενες είσοδοι είναι ένα κείμενο `prompt` (έως 2000 χαρακτήρες), τα `scene_image_url`, `wrist_image_url` και μια `state` 6 τιμών. Προαιρετικές είσοδοι ιστορικού (`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`. Παρέχετε τις μετρήσεις με χρονολογική σειρά για τα 7 control ticks αμέσως πριν από το `state`, στα 30 Hz.
command_historyπροαιρετικό
Τύποςarray[]
≤ 8 στοιχεία≥ 8 στοιχεία
Ιστορικό απόλυτων εντολών που απαιτεί `state_history`, με την πιο πρόσφατα απεσταλμένη εντολή στην τελευταία γραμμή. Οι γραμμές εκτείνονται χρονολογικά σε 8 ticks παρατήρησης και καθορίζουν την εντολή που ισχύει σε κάθε tick.
history_scene_image_urlπροαιρετικό
Τύποςurl · image
Είσοδος καρέ σκηνής από το ιστορικό που απαιτεί `state_history`· αν παραλειφθεί, χρησιμοποιείται το τρέχον καρέ. Το παρεχόμενο καρέ αντιστοιχεί στην παλαιότερη παρατήρηση του ιστορικού, 7 ticks πριν.
history_wrist_image_urlπροαιρετικό
Τύποςurl · image
Καρέ κάμερας καρπού στο παλαιότερο tick του ιστορικού· απαιτείται `state_history`.
num_inference_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή4
1 – 8
Αριθμός βημάτων αποθορυβοποίησης Euler· η επικύρωση checkpoint χρησιμοποίησε 4 βήματα.
guidance_scaleπροαιρετικό
Τύποςnumber
Προεπιλογή3
1 – 10
Ισχύς classifier-free guidance για βίντεο και ενέργεια· ορίστε την σε 1.0 για απενεργοποίηση του CFG.
seedπροαιρετικό
Τύποςinteger | null
Seed δειγματοληψίας με ρυθμίσεις αξιολόγησης αναφοράς του DROID: 0 και του SO-101: 42. Αν παραλειφθεί, επιλέγεται τυχαία seed.
απαιτείται

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το 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-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
actions
array of array of numberΠίνακας προβλεπόμενων ενεργειών με χρονολογικές γραμμές που αναπαριστούν βήματα ελέγχου· οι τιμές δεν περιορίζονται, επομένως τα όρια αρθρώσεων, ταχυτήτων και χώρου εργασίας πρέπει να επιβάλλονται στο ρομπότ. Στα 30 Hz, το SO-101 παρέχει 42x6 απόλυτες εντολές σε deg και gripper %· στα 15 Hz, το DROID παρέχει 32x8 απόλυτους στόχους αρθρώσεων σε rad συν το κλάσμα κλεισίματος της αρπάγης.
action_labels
array of stringΟνόματα που αντιστοιχούν στις στήλες ενεργειών.
action_hz
numberΣυχνότητα ελέγχου για τις γραμμές ενεργειών.
execute_steps
integerΑριθμός αρχικών ενεργειών προς εκτέλεση πριν από την αίτηση νέου τμήματος.
seed
integerΤυχαίο seed που χρησιμοποιείται κατά τη δειγματοληψία.
timings
objectΜετρήσεις χρονισμού από τον διακομιστή, εκφρασμένες σε δευτερόλεπτα.

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/flux-3-action/so101.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt