Passer au contenu

Uso

Intégrer

Identifiant du modèle uso
# 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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "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,10 $ 100 crédits API L’exécuter sur cette page

Obtenir une clé API
ByteDance Édition d’image #image-to-image

Génération d'images guidée par le style et le sujet à partir d'une image de contenu et d'une ou deux images de style

ByteDance · 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.

par défaut

Texte du prompt de génération ; laissez-le vide pour effectuer uniquement un transfert de style.

•requis
Déposez un fichier, ou

Liste d'URL d'images dans cet ordre : [content_image, style_image, extra_style_image].

image_size par défaut square_hd

Dimensions de l’image générée.

num_images par défaut 1

Nombre d’images générées simultanément.

Avancé negative_prompt · output_format · num_inference_steps · guidance_scale · seed · keep_size · enable_safety_checker
par défaut

Contenu indésirable à exclure de l'image, notamment les éléments, styles et artefacts.

output_format par défaut png

Format de l'image de sortie : PNG conserve la transparence, tandis que JPEG produit des fichiers plus petits.

par défaut 28

Nombre d'itérations de débruitage, pour lequel un temps de génération plus long peut offrir une meilleure qualité à mesure que le nombre augmente.

par défaut 4

Contrôle de l'adhérence au prompt : augmentez cette valeur pour que le résultat suive davantage le prompt.

Graine contrôlant le caractère aléatoire de la génération. La réutilisation d'une graine produit des résultats cohérents et reproductibles.

POST /run/uso?wait=20 devis → 0,10 $
# 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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "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 à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Uso

Prend `input_image_urls` dans l'ordre suivant : image de contenu, image de style et image de style supplémentaire facultative. Le prompt peut être vide pour un transfert de style pur, et `negative_prompt` exclut les éléments indésirables. `keep_size` préserve la mise en page et les dimensions de l'image de contenu. Le modèle produit 1 à 4 images par exécution, avec 1 à 50 étapes et une sortie PNG ou JPEG.

Paramètres

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

NomType Par défautAutorisé Description
promptfacultatif
Typestring
Par défaut
Texte du prompt de génération ; laissez-le vide pour effectuer uniquement un transfert de style.
input_image_urlsrequis
Typeurl[] · image
Liste d'URL d'images dans cet ordre : [content_image, style_image, extra_style_image].
image_sizefacultatif
Typeobject
Par défautsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions de l’image générée.
negative_promptfacultatif
Typestring
Par défaut
Contenu indésirable à exclure de l'image, notamment les éléments, styles et artefacts.
num_inference_stepsfacultatif
Typeinteger
Par défaut28
1 – 50
Nombre d'itérations de débruitage, pour lequel un temps de génération plus long peut offrir une meilleure qualité à mesure que le nombre augmente.
guidance_scalefacultatif
Typenumber
Par défaut4
1 – 10
Contrôle de l'adhérence au prompt : augmentez cette valeur pour que le résultat suive davantage le prompt.
keep_sizefacultatif
Typeboolean
Par défautfalse
Conserve la taille et la disposition de l'image de contenu pendant son traitement, une option utile pour transférer un style.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 4
Nombre d’images générées simultanément.
seedfacultatif
Typeinteger | null
Graine contrôlant le caractère aléatoire de la génération. La réutilisation d'une graine produit des résultats cohérents et reproductibles.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Active la détection et le filtrage du contenu NSFW.
output_formatfacultatif
Typeenum
Par défautpng
jpegpng
Format de l'image de sortie : PNG conserve la transparence, tandis que JPEG produit des fichiers plus petits.
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": "uso",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "input_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 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 générées intégrant une personnalisation du style, du sujet, ou les deux.
seed
integerValeur de graine utilisée pendant la génération.
has_nsfw_concepts
array of booleanRésultats de détection NSFW pour chaque image générée.
prompt
stringPrompt utilisé pendant la génération.
timings
objectMesures de durée d'exécution ventilées par étape.

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/uso.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt