Gunakan Topaz Image Upscaler melalui Rivya Public API v1 dengan ID model topaz-image-upscale, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanImej

ID model API

topaz-image-upscale

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

per_image · 2K=10 · 4K=20 · 8K=40 · ⌈total⌉

Keupayaan

Imej

Bil

FIXED

Had prompt

Tiada had prompt didokumenkan

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	topaz-image-upscale	Gunakan ID model API topaz-image-upscale.
prompt	string	Tidak	-	Teks prompt untuk model yang menyokong input teks.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
upscale_factor	select	Tidak	2	-	1, 2, 4	Faktor pembesaran

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Imej sumber: Tepat 1 imej JPEG, PNG atau WebP sehingga 10 MB; sisi terpanjang output ≤ 8192 px.

Fail maksimum

Jenis fail diterima

image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	10 MB	image/jpeg, image/png, image/webp

Permintaan minimum

{
  "model": "topaz-image-upscale",
  "params": {
    "upscale_factor": "2"
  }
}

Permintaan fail rujukan

{
  "model": "topaz-image-upscale",
  "params": {
    "upscale_factor": "2",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

{
  "id": "task_topaz_image_upscale_example",
  "status": "queued",
  "model": "topaz-image-upscale",
  "reserved_credits": 40,
  "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
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Topaz Image Upscaler