Χρησιμοποιήστε το Seedream 3.0 μέσω Rivya Public API v1 με model id seedream-3-0, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

Διαθέσιμο μέσω APIText input έτοιμοΕικόνα

ID μοντέλου API

seedream-3-0

Inputs

text

Files API

Δεν απαιτείται για το minimal request

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

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	seedream-3-0	Χρησιμοποιήστε το seedream-3-0 ως API model id.
prompt	string	Ναι	-	Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

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

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
image_size	select	Όχι	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Ελέγχει το σχήμα κάδρου της εξόδου. Το Square HD είναι η τρέχουσα προεπιλογή και λειτουργεί καλά για τις περισσότερες γενικές συνθέσεις.
guidance_scale	number	Όχι	2.5	min 1 / max 10 / step 0.1	-	Οι έγκυρες τιμές είναι από 1 έως 10. Οι υψηλότερες τιμές συνήθως ακολουθούν το prompt πιο πιστά, αλλά μπορούν επίσης να κάνουν την έξοδο πιο άκαμπτη.
seed	number	Όχι	-	min 0 / max 2147483647	-	Αφήστε το κενό για ένα νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση ενός προηγούμενου αποτελέσματος. Παραμένει πιο κοντά μόνο όταν το prompt και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες και δεν εγγυάται αντιστοίχιση 1:1.

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

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

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

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

{
  "id": "task_seedream_3_0_example",
  "status": "queued",
  "model": "seedream-3-0",
  "reserved_credits": 5,
  "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