Dokumentacja Rivya AI
Strony API modeli

Integracja API 4o Image

Używaj 4o Image przez Rivya Public API v1 z identyfikatorem modelu 4o-image, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIWejście tekstowe gotoweObraz
Identyfikator modelu API

4o-image

Wejścia

text

Files API

Niewymagane dla żądania minimalnego

Kredyty bazowe

3

Możliwość

Obraz

Rozliczenia

FIXED

Limit promptu

Brak udokumentowanego limitu promptu

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

KluczTypWymaganeDomyślnieOpis
modelstringTak4o-imageUżyj 4o-image jako identyfikatora modelu API.
promptstringTak-Tekst promptu dla modeli obsługujących wejście tekstowe.
paramsobjectNie-Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_idstringNie-Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

KluczTypWymaganeDomyślnieZakresOpcjeOpis
sizeselectNie1:1-1:1, 3:2, 2:3Proporcje obrazu

Żądanie minimalne

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.

{
  "id": "task_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "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
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.