Intégration API Qwen2 Image
Utilisez Qwen2 Image via Rivya Public API v1 avec le model id qwen2-image, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.
qwen2-image
text, file
Requis pour les modes avec référence
6
Image
FIXED
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 | qwen2-image | Utilisez qwen2-image comme ID de modèle API. |
| prompt | string | Oui | - | Maximum 800 caractères pour ce modèle. |
| params | object | Non | - | 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 |
|---|---|---|---|---|---|---|
| image_size | select | Non | 16:9 | - | 1:1, 3:4, 4:3, 9:16, 16:9 | Taille d'image |
| output_format | select | Non | png | - | png, jpeg | Format de sortie |
| seed | number | Non | - | min 0 | - | 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. |
| nsfw_checker | select | Non | false | - | false, true | Filtre de contenu |
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.
Image de reference: Importez jusqu'a 1 fichier image pour les projets image.
1
image
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 |
Requête minimale
{
"model": "qwen2-image",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"image_size": "16:9",
"output_format": "png",
"seed": 0,
"nsfw_checker": "false"
}
}Requête avec fichier de référence
{
"model": "qwen2-image",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"image_size": "16:9",
"output_format": "png",
"seed": 0,
"nsfw_checker": "false",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}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_qwen2_image_example",
"status": "queued",
"model": "qwen2-image",
"reserved_credits": 6,
"final_credits": 0,
"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.