Χρησιμοποιήστε το Qwen Image 3.0 Pro μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου qwen-image-3-pro, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΚείμενο ή URL έτοιμο. Οι λειτουργίες αναφοράς χρησιμοποιούν το Files APIΕικόνα

ID μοντέλου API

qwen-image-3-pro

Είσοδοι

text, file

Files API

Απαιτείται για λειτουργίες αναφοράς

Βασικές πιστώσεις

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

800 χαρακτήρες

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	qwen-image-3-pro	Χρησιμοποιήστε το qwen-image-3-pro ως αναγνωριστικό μοντέλου API.
prompt	string	Ναι	-	Μέγιστο 800 χαρακτήρες για αυτό το μοντέλο.
params	object	Ναι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
resolution	select	Ναι	1K	-	1K, 2K	Ανάλυση
image_size	select	Όχι	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Μέγεθος εικόνας
output_format	select	Όχι	png	-	png, jpeg	Μορφή εξόδου
prompt_extend	select	Όχι	true	-	true, false	Επιτρέψτε στο μοντέλο να αναδιατυπώσει ένα απλό θετικό prompt πριν από τη δημιουργία ή απενεργοποιήστε τη λειτουργία για αυστηρότερο έλεγχο της διατύπωσης.
nsfw_checker	select	Όχι	false	-	false, true	Ενεργοποιήστε το προαιρετικό φίλτρο περιεχομένου του μοντέλου. Κανένα αυτοματοποιημένο φίλτρο δεν μπορεί να εγγυηθεί πλήρη κάλυψη.
negative_prompt	text	Όχι	-	-	-	Αρνητικό prompt
seed	number	Όχι	1	min 0 / max 2147483647 / step 1	-	Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Εικόνες αναφοράς: Ανεβάστε έως τρεις εικόνες JPEG, PNG, WebP, BMP, GIF ή TIFF, με μέγιστο μέγεθος 10 MB η καθεμία.

Μέγιστος αριθμός αρχείων

Αποδεκτοί τύποι αρχείων

image

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Ελάχιστο αίτημα

{
  "model": "qwen-image-3-pro",
  "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": "Προαιρετικά στοιχεία ή αστοχίες προς αποφυγή, έως 5,000 χαρακτήρες.",
    "seed": 1
  }
}

Αίτημα με αρχείο αναφοράς

{
  "model": "qwen-image-3-pro",
  "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": "Προαιρετικά στοιχεία ή αστοχίες προς αποφυγή, έως 5,000 χαρακτήρες.",
    "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"
      }
    ]
  }
}

Απόκριση δημιουργίας

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

{
  "id": "task_qwen_image_3_pro_example",
  "status": "queued",
  "model": "qwen-image-3-pro",
  "reserved_credits": 7,
  "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
}

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.

Ενσωμάτωση API για Qwen Image 3.0 Pro