API integrace Midjourney
Použijte Midjourney přes Rivya Public API v1 s model id midjourney, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.
midjourney
text, file
Vyžadováno pro referenční režimy
3
Obrázek
FIXED
2000 znaků
Kontrakt požadavku
Model id posílejte na horní úrovni. Model-specific controls patří do params.
| Klíč | Typ | Povinné | Výchozí | Popis |
|---|---|---|---|---|
| model | string | Ano | midjourney | Použijte API model id midjourney. |
| prompt | string | Ano | - | Maximum 2000 znaků pro tento model. |
| params | object | Ne | - | Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže. |
| client_request_id | string | Ne | - | Volitelné client-side id pro trasování požadavků ve vašem systému. |
Parametry modelu
| Klíč | Typ | Povinné | Výchozí | Rozsah | Možnosti | Popis |
|---|---|---|---|---|---|---|
| speed | select | Ne | relaxed | - | relaxed, fast, turbo | Režim rychlosti |
| aspectRatio | select | Ne | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 | Poměr stran |
| version | select | Ne | 7 | - | 7, 6.1, 6, niji7, niji6 | Verze |
Pravidla nahrávání
Nejprve nahrajte referenční soubory a potom vložte vrácenou URL a duration token do params.referenceMediaItems.
Referenční obrázek: Nahrajte až 4 obrazové soubory pro obrazové projekty.
4
image
Video a audio reference by měly nést durationToken z /api/v1/files, když je vyžadováno ověření délky.
| kind | Max. velikost | MIME typy |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimální požadavek
{
"model": "midjourney",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"speed": "relaxed",
"aspectRatio": "1:1",
"version": "7"
}
}Požadavek s referenčním souborem
{
"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"
}
]
}
}Odpověď vytvoření
Create endpoint vrátí public task id. Pollujte status endpoint, dokud úloha neuspěje nebo neselže.
{
"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
}Běžné chyby
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Některé režimy vyžadují referenční nahrání přes Files API.