Použijte GPT Image 1.5 přes Rivya Public API v1 s model id gpt-image-1-5, 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 APIImage

ID API modelu

gpt-image-1-5

Vstupy

text, file

Files API

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

Základní kredity

Schopnost

Image

Fakturace

FIXED

Limit promptu

Není zdokumentovaný žádný limit promptu

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	gpt-image-1-5	Použijte API model id gpt-image-1-5.
prompt	string	Ano	-	Text promptu pro modely, které podporují textový vstup.
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
quality	select	Ne	medium	-	medium, high	Kvalita
aspect_ratio	select	Ne	1:1	-	1:1, 2:3, 3:2	Poměr stran

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ž 16 obrazových souborů pro obrazové projekty.

Max. souborů

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.

kind	Max. velikost	MIME typy
image	10 MB	image/jpeg, image/png, image/webp

Minimální požadavek

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

Požadavek s referenčním souborem

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1",
    "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_gpt_image_1_5_example",
  "status": "queued",
  "model": "gpt-image-1-5",
  "reserved_credits": 4,
  "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.

API integrace GPT Image 1.5