Έγγραφα Rivya AI
Σελίδες API μοντέλων

Wan 2.7 Image Pro API integration

Χρησιμοποιήστε το Wan 2.7 Image Pro μέσω Rivya Public API v1 με model id wan-2-7-image-pro, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

Διαθέσιμο μέσω APIText ή URL ready. Τα reference modes χρησιμοποιούν Files APIΕικόνα
ID μοντέλου API

wan-2-7-image-pro

Inputs

text, file

Files API

Απαιτείται για reference modes

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

12

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.

KeyΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιwan-2-7-image-proΧρησιμοποιήστε το wan-2-7-image-pro ως API model id.
promptstringΝαι-Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο.
paramsobjectΌχι-Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_idstringΌχι-Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

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

KeyΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
aspect_ratioselectΌχι1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8Αναλογία πλευρών
resolutionselectΌχι2K-1K, 2KΑνάλυση
watermarkselectΌχιfalse-false, trueΥδατογράφημα
seednumberΌχι-min 0 / max 2147483647 / step 1-Αφήστε το κενό για ένα νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση ενός προηγούμενου αποτελέσματος. Παραμένει πιο κοντά μόνο όταν το prompt και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες και δεν εγγυάται αντιστοίχιση 1:1.

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

Ανεβάστε πρώτα reference files και μετά τοποθετήστε το returned URL και το duration token μέσα στο params.referenceMediaItems.

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

Εικόνα αναφοράς: Ανέβασε έως 9 αρχεία εικόνας για έργα επεξεργασίας εικόνας.

Max files

9

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

image

Token διάρκειας

Τα video και audio references πρέπει να μεταφέρουν durationToken από /api/v1/files όταν απαιτείται duration verification.

kindMax sizeMIME types
image20 MBimage/jpeg, image/png, image/webp

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

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

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

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

Το create endpoint επιστρέφει public task id. Κάντε poll στο status endpoint μέχρι το task να succeed ή fail.

{
  "id": "task_wan_2_7_image_pro_example",
  "status": "queued",
  "model": "wan-2-7-image-pro",
  "reserved_credits": 12,
  "final_credits": 0,
  "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

Ορισμένα modes απαιτούν reference uploads μέσω Files API.