Midjourney API-integratie
Gebruik Midjourney via Rivya Public API v1 met model-id midjourney, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.
midjourney
text, file
Vereist voor referentiemodi
3
Image
FIXED
2000 tekens
Requestcontract
Stuur de model-id op topniveau. Modelspecifieke controles horen in params.
| Key | Type | Vereist | Standaard | Beschrijving |
|---|---|---|---|---|
| model | string | Ja | midjourney | Gebruik de API-model-id midjourney. |
| prompt | string | Ja | - | Maximaal 2000 tekens voor dit model. |
| params | object | Nee | - | Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys. |
| client_request_id | string | Nee | - | Optionele client-side id voor requesttracing in je systeem. |
Modelparameters
| Key | Type | Vereist | Standaard | Bereik | Opties | Beschrijving |
|---|---|---|---|---|---|---|
| speed | select | Nee | relaxed | - | relaxed, fast, turbo | Snelheidsmodus |
| aspectRatio | select | Nee | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 | Beeldverhouding |
| version | select | Nee | 7 | - | 7, 6.1, 6, niji7, niji6 | Versie |
Uploadbeleid
Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.
Referentiebeeld: Upload maximaal 4 afbeeldingsbestanden voor beeldprojecten.
4
image
Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.
| kind | Max. grootte | MIME-types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimale request
{
"model": "midjourney",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"speed": "relaxed",
"aspectRatio": "1:1",
"version": "7"
}
}Request met referentiebestand
{
"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-response
Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.
{
"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
}Veelvoorkomende fouten
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Sommige modi vereisen referentie-uploads via Files API.