Utilisez Qwen Image 3.0 via Rivya Public API v1 avec le model id qwen-image-3, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APITexte ou URL prêt ; les modes de référence utilisent Files APIImage

ID de modèle API

qwen-image-3

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

Capacité

Image

Facturation

FIXED

Limite de prompt

800 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	qwen-image-3	Utilisez qwen-image-3 comme ID de modèle API.
prompt	string	Oui	-	Maximum 800 caractères pour ce modèle.
params	object	Oui	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
resolution	select	Oui	1K	-	1K, 2K	Résolution
image_size	select	Non	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Dimensions de l’image
output_format	select	Non	png	-	png, jpeg	Format de sortie
prompt_extend	select	Non	true	-	true, false	Laissez le modèle réécrire un prompt positif simple avant la génération, ou désactivez cette option pour mieux maîtriser le texte.
nsfw_checker	select	Non	false	-	false, true	Activez le filtre de contenu facultatif du modèle. Aucun filtre automatisé ne peut garantir une couverture complète.
negative_prompt	text	Non	-	-	-	Prompt négatif
seed	number	Non	1	min 0 / max 2147483647 / step 1	-	Laissez ce champ vide pour obtenir un nouveau résultat aléatoire à chaque fois. Réutiliser le même entier facilite la reproduction ou l'ajustement fin d'un résultat précédent. Le résultat reste plus proche uniquement si le prompt et les autres réglages clés restent eux aussi similaires, et cela ne garantit pas une correspondance 1:1.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Images de référence: Importez jusqu’à trois images JPEG, PNG, WebP, BMP, GIF ou TIFF de 10 MB maximum chacune.

Nombre max. de fichiers

Types de fichier acceptés

image

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Requête minimale

{
  "model": "qwen-image-3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "Éléments ou défauts facultatifs à éviter, jusqu’à 5,000 caractères.",
    "seed": 1
  }
}

Requête avec fichier de référence

{
  "model": "qwen-image-3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "Éléments ou défauts facultatifs à éviter, jusqu’à 5,000 caractères.",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

{
  "id": "task_qwen_image_3_example",
  "status": "queued",
  "model": "qwen-image-3",
  "reserved_credits": 5,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Qwen Image 3.0