Używaj Ideogram V3 Remix przez Rivya Public API v1 z identyfikatorem modelu ideogram-v3-remix, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIGotowośćObraz

Identyfikator modelu API

ideogram-v3-remix

Wejścia

file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

Możliwość

Obraz

Rozliczenia

FIXED

Limit promptu

5000 znaków

Kontrakt żądania

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

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	ideogram-v3-remix	Użyj ideogram-v3-remix jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 5000 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
rendering_speed	select	Nie	BALANCED	-	TURBO, BALANCED, QUALITY	Równoważy szybkość, koszt i szczegółowość. Turbo jest najszybsze i najtańsze, Quality daje najwięcej szczegółów i kosztuje najwięcej, a Balanced to domyślny środek.
style	select	Nie	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN	Styl
expand_prompt	select	Nie	true	-	true, false	Przełącznik rozszerzania promptu w Ideogram. Włączenie pomaga modelowi rozbudować opis; wyłączenie jest lepsze, gdy chcesz ściśle kontrolować prompt.
image_size	select	Nie	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Rozmiar obrazu
num_images	select	Nie	1	-	1, 2, 3, 4	Wybierz 1–4 wyniki. Łączny koszt to stawka za obraz pomnożona przez wybraną liczbę, zaokrąglona w górę do pełnych kredytów.
seed	number	Nie	-	-	-	Pozostaw puste, aby za każdym razem uzyskać nowy losowy wynik. Ponowne użycie tej samej liczby całkowitej ułatwia odtworzenie albo dopracowanie poprzedniego wyniku. Wynik pozostaje bliższy tylko wtedy, gdy prompt i inne kluczowe ustawienia również pozostają podobne; nie jest to gwarantowane dopasowanie 1:1.
strength	number	Nie	0.8	min 0.01 / max 1	-	Kontroluje, jak mocno obraz źródłowy kształtuje wynik. Wyższe wartości pozostają bliżej oryginalnej struktury, a niższe pozwalają na większe odchylenie.
negative_prompt	text	Nie	-	-	-	Negatywny prompt

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Obraz referencyjny: Prześlij dokładnie 1 plik obrazu dla tego projektu.

Maks. plików

Akceptowane rodzaje plików

image

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy MIME
image	10 MB	image/jpeg, image/png, image/webp

Żądanie minimalne

{
  "model": "ideogram-v3-remix",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "strength": 0.8,
    "negative_prompt": "Opcjonalne rzeczy do uniknięcia"
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "ideogram-v3-remix",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "strength": 0.8,
    "negative_prompt": "Opcjonalne rzeczy do uniknięcia",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Odpowiedź tworzenia

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

{
  "id": "task_ideogram_v3_remix_example",
  "status": "queued",
  "model": "ideogram-v3-remix",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Ideogram V3 Remix