Accéder 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 de l'invite de génération ; laissez-le vide pour effectuer uniquement un transfert de style.

•obligatoire
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, qui échange un temps de génération plus long contre une qualité potentiellement meilleure à mesure que le nombre augmente.

par défaut 4

Contrôle de l'adhérence à l'invite : augmentez cette valeur pour que le résultat suive l'invite de plus près.

Graine contrôlant l'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. L’invite 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. 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 de l'invite de génération ; laissez-le vide pour effectuer uniquement un transfert de style.
input_image_urlsobligatoire
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, qui échange un temps de génération plus long contre une qualité potentiellement meilleure à mesure que le nombre augmente.
guidance_scalefacultatif
Typenumber
Par défaut4
1 – 10
Contrôle de l'adhérence à l'invite : augmentez cette valeur pour que le résultat suive l'invite de plus près.
keep_sizefacultatif
Typeboolean
Par défautfalse
Conserve la taille et la disposition de l'image de contenu lors de 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 l'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.
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": "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 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 générées intégrant une personnalisation du style, du sujet, ou les deux.
seed
integerValeur de la graine utilisée pendant la génération.
has_nsfw_concepts
array of booleanRésultats de la détection NSFW pour chaque image générée.
prompt
stringInvite utilisée 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 à l'adresse https://doitong.com/fr-FR/developers/models/uso.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt