رفتن به محتوا
سارویتوسعه‌دهندگان
مستندات/ساخت محصول

نمونهٔ Python

یک نمونهٔ کامل با کتابخانهٔ استاندارد Python.

نصب وابستگی لازم نیست

این نمونه از urllib و json خود Python استفاده می‌کند. کلید را در محیط سرور تنظیم کنید و مقدار آن را در فایل کد نگذارید.

python
import json
import os
import urllib.request
import urllib.error
import uuid

body = {
    "model": "z-ai/glm-5.3-flash",
    "input": "یک پیام خوش‌آمدگویی کوتاه فارسی بنویس.",
    "max_output_tokens": 512
}
request = urllib.request.Request(
    "https://api.sarovi.ir/v1/responses",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["SAROVI_API_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4())
    },
    method="POST"
)
try:
    with urllib.request.urlopen(request, timeout=300) as response:
        result = json.load(response)
        print(result["output_text"])
        print("Request:", response.headers.get("X-Request-ID"))
except urllib.error.HTTPError as error:
    detail = json.load(error)
    print(error.code, detail["error"]["code"])

تلاش مجدد

ساخت UUID در نمونه برای یک اجراست. اگر خودتان retry اضافه می‌کنید، همان request و Idempotency-Key را نگه دارید. تولید UUID تازه داخل حلقهٔ retry می‌تواند کار پولی تازه بسازد.

ذخیرهٔ تصویر

در خروجی Studio image، outputs را پیمایش کنید و برای هر data از base64.b64decode استفاده کنید. فایل را با حالت wb بنویسید. پسوند را بر اساس mediaType تعیین کنید؛ تمام خروجی‌ها الزاماً PNG نیستند.

قرارداد API 1.6.0 · تاریخچهٔ تغییرات