Dùng 4o Image qua Rivya Public API v1 với model id 4o-image, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.

Khả dụng qua APIText input sẵn sàngHình ảnh

ID mô hình API

4o-image

Input

text

Files API

Không bắt buộc cho minimal request

Tín dụng cơ bản

Năng lực

Hình ảnh

Thanh toán

FIXED

Giới hạn prompt

Không có giới hạn prompt được ghi

Hợp đồng yêu cầu

Gửi model id ở top level. Điều khiển riêng của mô hình nằm trong params.

Key	Type	Bắt buộc	Default	Mô tả
model	string	Có	4o-image	Dùng API model id 4o-image.
prompt	string	Có	-	Prompt text cho mô hình hỗ trợ text input.
params	object	Không	-	Object tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép.
client_request_id	string	Không	-	Client-side id tùy chọn để trace request trong hệ thống của bạn.

Tham số mô hình

Key	Type	Bắt buộc	Default	Range	Options	Mô tả
size	select	Không	1:1	-	1:1, 3:2, 2:3	Tỷ lệ khung hình

Yêu cầu tối thiểu

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

Phản hồi tạo

Create endpoint trả về public task id. Poll status endpoint cho đến khi task succeeded hoặc failed.

{
  "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
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found