Accéder au contenu

Flux 3 Action

Intégrer

Identifiant du modèle 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"

Cette requête: ≈0,003 $ 3 crédits API L'exécuter sur cette page

Obtenir une clé API
Black Forest Labs Vidéo vers vidéo #robotic#arm

Modèle de politique robotique qui prédit les séquences d’actions du bras SO-101 à partir d’images de caméra, de l’état des articulations et d’une instruction

Créé sur Doitong

Créations publiques réalisées avec Flux 3 Action par la communauté Doitong. Réutilisez une invite en un clic.

Créations publiques affichées : 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...

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•obligatoire 88 / 2000

Instructions de tâche pour le robot exprimées en langage naturel.

•obligatoire
Déposez un fichier ou

Image de la tuile gauche affichant l'image actuelle de la caméra de scène fixe après redimensionnement à 256x256.

•obligatoire
Déposez un fichier ou

Image actuelle de la caméra du poignet, placée dans la tuile droite et redimensionnée à 256x256.

•obligatoire

Valeurs d'état mesurées dans l'ordre : rotation et élévation de l'épaule, flexion du coude, flexion et rotation du poignet, toutes en degrés, suivies de la position de la pince en pourcentage.

Avancé history_scene_image_url · history_wrist_image_url · num_inference_steps · guidance_scale · seed · state_history · command_history
Déposez un fichier ou

Entrée d'image de scène historique nécessitant `state_history` ; son omission utilise l'image actuelle. L'image fournie représente l'observation historique la plus ancienne, 7 cycles auparavant.

Déposez un fichier ou

Image de la caméra du poignet au cycle historique le plus ancien ; `state_history` est requis.

par défaut 4

Nombre d'étapes de débruitage d'Euler ; la validation du checkpoint a utilisé 4 étapes.

par défaut 3

Intensité du guidage sans classifieur pour la vidéo et l'action ; définissez-la sur 1.0 pour désactiver CFG.

Graine d'échantillonnage avec les paramètres d'évaluation de référence de DROID : 0 et SO-101 : 42. Si elle n'est pas spécifiée, une graine est sélectionnée aléatoirement.

Historique des états mesurés, omis pour un épisode initial et nécessitant sinon `command_history`. Fournissez les mesures dans l'ordre chronologique pour les 7 cycles de contrôle précédant immédiatement `state`, à 30 Hz.

Historique des commandes absolues nécessitant `state_history`, la commande envoyée la plus récemment figurant sur la dernière ligne. Les lignes sont chronologiques sur 8 cycles d'observation et indiquent la commande active à chaque cycle.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Flux 3 Action

Au lieu de médias, ce modèle renvoie du JSON contenant les `actions` prédites, leur fréquence de contrôle, les libellés des colonnes et le nombre d’étapes initiales à exécuter (`execute_steps`) avant de demander une nouvelle séquence. Les entrées obligatoires sont un `prompt` textuel (jusqu’à 2000 caractères), `scene_image_url`, `wrist_image_url` et un `state` à 6 valeurs. Les entrées d’historique facultatives (`state_history`, `command_history`, images d’historique) fournissent un contexte temporel. `num_inference_steps` varie de 1 à 8 et `guidance_scale` de 1 à 10.

Paramètres

NomType Par défautAutorisé Description
promptobligatoire
Typestring
≤ 2 000 caractères
Instructions de tâche pour le robot exprimées en langage naturel.
scene_image_urlobligatoire
Typeurl · image
Image de la tuile gauche affichant l'image actuelle de la caméra de scène fixe après redimensionnement à 256x256.
wrist_image_urlobligatoire
Typeurl · image
Image actuelle de la caméra du poignet, placée dans la tuile droite et redimensionnée à 256x256.
stateobligatoire
Typenumber[]
≤ 6 éléments≥ 6 éléments
Valeurs d'état mesurées dans l'ordre : rotation et élévation de l'épaule, flexion du coude, flexion et rotation du poignet, toutes en degrés, suivies de la position de la pince en pourcentage.
state_historyfacultatif
Typearray[]
≤ 7 éléments≥ 7 éléments
Historique des états mesurés, omis pour un épisode initial et nécessitant sinon `command_history`. Fournissez les mesures dans l'ordre chronologique pour les 7 cycles de contrôle précédant immédiatement `state`, à 30 Hz.
command_historyfacultatif
Typearray[]
≤ 8 éléments≥ 8 éléments
Historique des commandes absolues nécessitant `state_history`, la commande envoyée la plus récemment figurant sur la dernière ligne. Les lignes sont chronologiques sur 8 cycles d'observation et indiquent la commande active à chaque cycle.
history_scene_image_urlfacultatif
Typeurl · image
Entrée d'image de scène historique nécessitant `state_history` ; son omission utilise l'image actuelle. L'image fournie représente l'observation historique la plus ancienne, 7 cycles auparavant.
history_wrist_image_urlfacultatif
Typeurl · image
Image de la caméra du poignet au cycle historique le plus ancien ; `state_history` est requis.
num_inference_stepsfacultatif
Typeinteger
Par défaut4
1 – 8
Nombre d'étapes de débruitage d'Euler ; la validation du checkpoint a utilisé 4 étapes.
guidance_scalefacultatif
Typenumber
Par défaut3
1 – 10
Intensité du guidage sans classifieur pour la vidéo et l'action ; définissez-la sur 1.0 pour désactiver CFG.
seedfacultatif
Typeinteger | null
Graine d'échantillonnage avec les paramètres d'évaluation de référence de DROID : 0 et SO-101 : 42. Si elle n'est pas spécifiée, une graine est sélectionnée aléatoirement.
obligatoire

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu'à 10 MB ou le file_url d'un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au modèle.
Champs de sortie
actions
array of array of numberTableau d'actions prédites dont les lignes chronologiques représentent les étapes de contrôle ; les valeurs ne sont pas écrêtées, les limites des articulations, de la vitesse et de l'espace de travail doivent donc être appliquées sur le robot. À 30 Hz, SO-101 fournit 42x6 commandes absolues en degrés et en % de pince ; à 15 Hz, DROID fournit 32x8 cibles articulaires absolues en radians, ainsi que la fraction de fermeture de la pince.
action_labels
array of stringNoms correspondant aux colonnes d'action.
action_hz
numberFréquence de contrôle des lignes d'action.
execute_steps
integerNombre d'actions initiales à exécuter avant de demander un autre bloc.
seed
integerGraine aléatoire utilisée pendant l'échantillonnage.
timings
objectMesures temporelles du serveur, exprimées en secondes.

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/flux-3-action/so101.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt