Accéder au contenu

Hidream O1 Image · Dev · Edit

Intégrer

Identifiant du modèle hidream-o1-image/dev/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hidream-o1-image/dev/edit?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: 0,02 $ 20 crédits API · ≈ 2,11 ₽ L'exécuter sur cette page

Obtenir une clé API
HiDream Édition d’image Entrées de référence

Variante dev distillée pour la modification à partir d'images de référence, 28 étapes et guidage 0 par défaut

HiDream · Image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

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

Instructions textuelles pour générer ou modifier des images, ou pour la personnalisation guidée par un sujet.

•obligatoire reference_image_urls
Déposez un fichier ou

Images fournies comme références pour la modification ou la personnalisation guidée par un sujet.

image_size par défaut {"height":2048,"width...

Choisissez les dimensions de l'image ; pour les sorties basées sur des images de référence, cette requête est adaptée à la résolution prise en charge la plus proche, avec un maximum approximatif de 2048 × 2048 pixels.

num_images par défaut 1

Nombre d’images à produire.

Avancé output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · keep_original_aspect
output_format par défaut png

Format de fichier de l'image résultante.

par défaut 28

Nombre d'itérations de débruitage, 28 étapes correspondant à la cible de distillation du modèle dev.

par défaut 0

Échelle du guidage sans classifieur ; par défaut, 0.0 pour le modèle dev.

Seed aléatoire rendant la génération reproductible.

POST /run/hidream-o1-image/dev/edit?wait=20 devis → 0,02 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hidream-o1-image/dev/edit?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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 Hidream O1 Image · Dev · Edit

Modifie ou personnalise des images à partir d'images de référence (`reference_image_urls`) et d'un `prompt` textuel, avec le modèle dev distillé et optimisé pour 28 étapes, l'échelle de guidage étant définie par défaut sur 0. La sortie atteint environ 2048x2048 via des préréglages de taille ou des dimensions personnalisées. Renvoie 1 à 4 images en PNG, JPEG ou WebP, et `keep_original_aspect` conserve la forme d'une référence unique.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
promptobligatoire
Typestring
Instructions textuelles pour générer ou modifier des images, ou pour la personnalisation guidée par un sujet.
reference_image_urlsobligatoire images
Typeurl[] · image
Images fournies comme références pour la modification ou la personnalisation guidée par un sujet.
image_sizefacultatif
Typeobject
Par défaut{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Choisissez les dimensions de l'image ; pour les sorties basées sur des images de référence, cette requête est adaptée à la résolution prise en charge la plus proche, avec un maximum approximatif de 2048 × 2048 pixels.
num_inference_stepsfacultatif
Typeinteger
Par défaut28
1 – 28
Nombre d'itérations de débruitage, 28 étapes correspondant à la cible de distillation du modèle dev.
guidance_scalefacultatif
Typenumber
Par défaut0
0 – 20
Échelle du guidage sans classifieur ; par défaut, 0.0 pour le modèle dev.
seedfacultatif
Typeinteger | null
Seed aléatoire rendant la génération reproductible.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 4
Nombre d’images à produire.
output_formatfacultatif
Typeenum
Par défautpng
jpegpngwebp
Format de fichier de l'image résultante.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Contrôle la vérification de sécurité des images générées.
keep_original_aspectfacultatif
Typeboolean
Par défautfalse
Conservation du rapport hauteur/largeur pour une génération avec une seule référence : la sortie reprend les proportions de cette référence uniquement lorsqu'une seule image est fournie.
obligatoire Nom canonique, également accepté

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": "hidream-o1-image/dev/edit",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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
images
array of object {url, content_type, file_name, file_size, width, height}Images produites par la génération.
seed
integerValeur de graine appliquée pendant la génération.
has_nsfw_concepts
array of booleanÉtat du contrôle de sécurité pour chaque image générée.
prompt
stringInvite utilisée pour générer la sortie.
timings
objectMesures temporelles de la génération.

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/hidream-o1-image/dev/edit.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt