Midjourney API integration
Χρησιμοποιήστε το Midjourney μέσω Rivya Public API v1 με model id midjourney, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.
midjourney
text, file
Απαιτείται για reference modes
3
Εικόνα
FIXED
2000 χαρακτήρες
Σύμβαση αιτήματος
Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.
| Key | Τύπος | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|---|
| model | string | Ναι | midjourney | Χρησιμοποιήστε το midjourney ως API model id. |
| prompt | string | Ναι | - | Μέγιστο 2000 χαρακτήρες για αυτό το μοντέλο. |
| params | object | Όχι | - | Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys. |
| client_request_id | string | Όχι | - | Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα. |
Παράμετροι μοντέλου
| Key | Τύπος | Υποχρεωτικό | Προεπιλογή | Εύρος | Επιλογές | Περιγραφή |
|---|---|---|---|---|---|---|
| speed | select | Όχι | relaxed | - | relaxed, fast, turbo | Λειτουργία ταχύτητας |
| aspectRatio | select | Όχι | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 | Λόγος διαστάσεων |
| version | select | Όχι | 7 | - | 7, 6.1, 6, niji7, niji6 | Έκδοση |
Πολιτική μεταφόρτωσης
Ανεβάστε πρώτα reference files και μετά τοποθετήστε το returned URL και το duration token μέσα στο params.referenceMediaItems.
Εικόνα αναφοράς: Ανεβάστε έως 4 αρχεία εικόνας για έργα εικόνας.
4
image
Τα video και audio references πρέπει να μεταφέρουν durationToken από /api/v1/files όταν απαιτείται duration verification.
| kind | Max size | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Ελάχιστο αίτημα
{
"model": "midjourney",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"speed": "relaxed",
"aspectRatio": "1:1",
"version": "7"
}
}Αίτημα με αρχείο αναφοράς
{
"model": "midjourney",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"speed": "relaxed",
"aspectRatio": "1:1",
"version": "7",
"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_midjourney_example",
"status": "queued",
"model": "midjourney",
"reserved_credits": 3,
"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.