Dokumentace Rivya AI
Stránky API modelů

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í.

Dostupné přes APIText nebo URL připraveny; referenční režimy používají Files APIObrázek
ID API modelu

midjourney

Vstupy

text, file

Files API

Vyžadováno pro referenční režimy

Základní kredity

3

Schopnost

Obrázek

Fakturace

FIXED

Limit promptu

2000 znaků

Kontrakt požadavku

Model id posílejte na horní úrovni. Model-specific controls patří do params.

KlíčTypPovinnéVýchozíPopis
modelstringAnomidjourneyPoužijte API model id midjourney.
promptstringAno-Maximum 2000 znaků pro tento model.
paramsobjectNe-Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže.
client_request_idstringNe-Volitelné client-side id pro trasování požadavků ve vašem systému.

Parametry modelu

KlíčTypPovinnéVýchozíRozsahMožnostiPopis
speedselectNerelaxed-relaxed, fast, turboRežim rychlosti
aspectRatioselectNe1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3Poměr stran
versionselectNe7-7, 6.1, 6, niji7, niji6Verze

Pravidla nahrávání

Nejprve nahrajte referenční soubory a potom vložte vrácenou URL a duration token do params.referenceMediaItems.

Pravidlo reference

Referenční obrázek: Nahrajte až 4 obrazové soubory pro obrazové projekty.

Max. souborů

4

Přijímané typy souborů

image

Token délky trvání

Video a audio reference by měly nést durationToken z /api/v1/files, když je vyžadováno ověření délky.

kindMax. velikostMIME typy
image10 MBimage/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.