Passer 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 retouche à 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.

•requis

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

•requis reference_image_urls
Déposez un fichier, ou

Images fournies comme références pour la modification ou la personnalisation guidée par le 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 par le modèle qui s'en rapproche le plus, 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 obtenue.

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 de 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
promptrequis
Typestring
Instructions textuelles pour générer ou modifier des images, ou pour une personnalisation guidée par le sujet.
reference_image_urlsrequis images
Typeurl[] · image
Images fournies comme références pour la modification ou la personnalisation guidée par le 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 par le modèle qui s'en rapproche le plus, 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 obtenue.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Indique si les images générées sont soumises à un contrôle de sécurité.
keep_original_aspectfacultatif
Typeboolean
Par défautfalse
Conservation du rapport largeur-hauteur 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.
requis 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 dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du 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 du seed 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
stringPrompt utilisé 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 à https://doitong.com/fr/developers/models/hidream-o1-image/dev/edit.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt