4o Image modelini Rivya Public API v1 üzerinden model id 4o-image, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin girişi hazırGörsel

API model kimliği

4o-image

Girişler

text

Files API

Minimal istek için gerekli değil

Temel krediler

Kredi oranı: 3 / istek Görevin son maliyeti tam krediye yukarı yuvarlanır.

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

Belgelenmiş prompt limiti yok

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	4o-image	4o-image API model kimliği değerini kullanın.
prompt	string	Evet	-	Metin girişini destekleyen modeller için prompt metni.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
size	select	Hayır	1:1	-	1:1, 3:2, 2:3	En boy oranı

Minimal istek

{
  "model": "4o-image",
  "prompt": "Açık gri fonda, soldan yumuşak ışık alan bir ürün şişesi.",
  "params": {
    "size": "1:1"
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found