Χρησιμοποιήστε το Seedream 4.0 μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου seedream-4-0, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

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

ID μοντέλου API

seedream-4-0

Είσοδοι

text, file

Files API

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

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

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

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

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
image_size	select	Όχι	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9	Ελέγχει την αναλογία κάδρου. Μαζί με την ανάλυση εξόδου, καθορίζει τις τελικές διαστάσεις pixel.
image_resolution	select	Όχι	1K	-	1K, 2K, 4K	Οι τρέχουσες βαθμίδες είναι `1K`, `2K` και `4K`. Η υψηλότερη ανάλυση συνήθως σημαίνει μεγαλύτερα αρχεία και μεγαλύτερη αναμονή.
max_images	number	Όχι	1	min 1 / max 6 / step 1	-	Οι έγκυρες τιμές είναι από 1 έως 6. Ελέγχει πόσες εικόνες μπορεί να επιστρέψει μία εργασία, οπότε είναι καλύτερο να κρατάτε το prompt ευθυγραμμισμένο με αυτό το πλήθος.
seed	number	Όχι	-	min 0 / max 2147483647 / step 1	-	Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.
nsfw_checker	select	Όχι	false	-	false, true	Ελέγχει το φίλτρο περιεχομένου. Η απενεργοποίησή του σας φέρνει πιο κοντά στην ακατέργαστη έξοδο, αλλά σημαίνει επίσης ότι αποδέχεστε ένα ασθενέστερο επίπεδο ασφάλειας.

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

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

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

Εικόνες αναφοράς: Ανεβάστε έως 10 εικόνες για τη διαδρομή επεξεργασίας Seedream 4.0.

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

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

image

Token διάρκειας

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

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

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

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

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

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_seedream_4_0_example",
  "status": "queued",
  "model": "seedream-4-0",
  "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
}

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

Ενσωμάτωση API για Seedream 4.0