Passer au contenu

Hidream O1 Image · Edit

Intégrer

Identifiant du modèle hidream-o1-image/edit
# 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/hidream-o1-image/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: 0,04 $ 40 crédits API L’exécuter sur cette page

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

Retouche d’images de référence et personnalisation de sujet en qualité complète, jusqu’à environ 2048x2048, 50 étapes

HiDream · Image

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•requis

Instructions textuelles pour générer ou modifier des images, ou pour la personnalisation guidée par un 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 un sujet.

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

Choisissez les dimensions de l’image; pour les sorties fondées sur des images de référence, cette requête est associée à la résolution prise en charge la plus proche par le modèle, 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 50

Nombre d’étapes de débruitage à effectuer.

par défaut 5

Échelle du guidage sans classifieur; par défaut à 5.0 pour le modèle complet.

Valeur de départ aléatoire qui rend la génération reproductible.

POST /run/hidream-o1-image/edit?wait=20 devis → 0,04 $
# 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/hidream-o1-image/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.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 au Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Hidream O1 Image · Edit

Modifie des images ou crée des résultats axés sur le sujet à partir d’une ou plusieurs images de référence (`reference_image_urls`) et d’un `prompt` textuel. La taille de sortie utilise des préréglages ou une taille personnalisée, jusqu’à environ 2048x2048. Utilise par défaut 50 étapes de débruitage avec un guidage de 5 et peut retourner de 1 à 4 images en PNG, JPEG ou WebP. `keep_original_aspect` préserve le rapport d’aspect lorsqu’une seule référence est fournie.

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 la personnalisation guidée par un sujet.
reference_image_urlsrequis 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 fondées sur des images de référence, cette requête est associée à la résolution prise en charge la plus proche par le modèle, avec un maximum approximatif de 2048 × 2048 pixels.
num_inference_stepsfacultatif
Typeinteger
Par défaut50
1 – 50
Nombre d’étapes de débruitage à effectuer.
guidance_scalefacultatif
Typenumber
Par défaut5
0 – 20
Échelle du guidage sans classifieur; par défaut à 5.0 pour le modèle complet.
seedfacultatif
Typeinteger | null
Valeur de départ aléatoire qui rend 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
Détermine si les images générées font l’objet d’un contrôle de sécurité.
keep_original_aspectfacultatif
Typeboolean
Par défautfalse
Conservation des proportions pour la 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/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": 40,
    "usd": "0.04",
    "charged": 40,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 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, les vidéos et les fichiers 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 de durée de la génération.

Plus de modèles : Modification d’image

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/hidream-o1-image/edit.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt