Rivya AI दस्तावेज़
मॉडल API पेज

Z-Image API इंटीग्रेशन

Rivya Public API v1 के जरिए मॉडल id z-image, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Z-Image का उपयोग करें।

API से उपलब्धटेक्स्ट इनपुट तैयारछवि
API मॉडल id

z-image

इनपुट

text

Files API

न्यूनतम रिक्वेस्ट के लिए जरूरी नहीं

बेस क्रेडिट

1

क्षमता

छवि

बिलिंग

FIXED

प्रॉम्प्ट सीमा

1000 अक्षर

रिक्वेस्ट अनुबंध

मॉडल id को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।

Keyप्रकारजरूरीडिफॉल्टविवरण
modelstringहांz-imagez-image API मॉडल id का उपयोग करें।
promptstringहां-इस मॉडल के लिए अधिकतम 1000 अक्षर।
paramsobjectनहीं-मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें।
client_request_idstringनहीं-अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id।

मॉडल पैरामीटर

Keyप्रकारजरूरीडिफॉल्टसीमाविकल्पविवरण
aspect_ratioselectनहीं1:1-1:1, 4:3, 3:4, 16:9, 9:16Aspect ratio नियंत्रण

न्यूनतम रिक्वेस्ट

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

रिस्पॉन्स बनाएं

Create एंडपॉइंट सार्वजनिक टास्क id लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।

{
  "id": "task_z_image_example",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

सामान्य त्रुटियां

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Create एंडपॉइंट सार्वजनिक टास्क id लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।