Cliant Asincronach agus Feidhmíocht
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026 bunaithe ar leathanach Teorainneacha Ráta xAI agus ar thagairt API Íomhánna: Meastar teorainneacha an mhúnla Imagine mar iarratais in aghaidh an tsoicind—6 ag an leibhéal iontrála, 100 ag an leibhéal is airde—ní “30 in aghaidh an nóiméid”; cuireann seafamar teorainn le hiarratais chomhthreomhara, ní le tréchur; aschuirtear íomhánna mar JPEG de réir réamhshocraithe; agus téann na huainiúcháin shonracha ón seanleagan, nach dtagann ó aon tomhas foilsithe, in áit ríomh. Foinse: Teorainneacha Ráta · API Íomhánna.
Feidhmíocht a Optamú le Asincronacht
Nuair a theastaíonn uait go leor íomhánna a ghiniúint nó a chur in eagar, bíonn glaonna seicheamhacha ina mbac. Ligeann cliant asincronach API xAI duit iliomad iarratas a rith go comhthreomhar, ag laghdú go mór an t-am próiseála iomlán.
An Cliant AsyncOpenAI
Ní dhéanann asincronacht aon ghiniúint amháin níos tapúla: tógann iarratas íomhá amháin an méid céama ama go díreach. Cad a dhíothaíonn sé ná fanacht gan ghá idir iarratais—faoi fhad is atá an chéad íomhá á ríomh ar an bhfreastalaí, is féidir le do chlár deich gcinn eile a iarraidh in ionad fanacht blocáilte. Sin an fáth go bhfuil an gnóthachan nialasach d’íomhá amháin agus dramatach do chaoga.
from openai import AsyncOpenAI
import asyncio
import os
async_client = AsyncOpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
async def generate_image(prompt):
"""Giníonn sé íomhá go hasincronach."""
response = await async_client.images.generate(
model="grok-imagine-image",
prompt=prompt,
extra_body={"resolution": "1k"},
)
return response.data[0].url
async def main():
url = await generate_image("A lighthouse on a cliff, watercolor style")
print(url)
asyncio.run(main())
Iarratais Chomhthreomhara le asyncio.gather
Seolann asyncio.gather gach iarratas agus ansin fanann sé go gcríochnaíonn an tacar. Bíonn an fad iomlán comhionann leis an gceann is moille, ní suim na n-iarratas go léir—sin an difríocht iomlán, agus feiceann tú é le trí nó ceithre íomhá amháin.
async def generate_batch(prompts):
"""Giníonn sé íomhánna do leideanna iolracha go comhthreomhar."""
tasks = [generate_image(prompt) for prompt in prompts]
results = await asyncio.gather(*tasks)
return results
async def main():
prompts = [
"Portrait of an engineer, corporate style",
"Panoramic view of a futuristic city",
"Isometric diagram of a data center",
"Abstract blue and silver logo",
"Illustration of a team in a meeting"
]
urls = await generate_batch(prompts)
for prompt, url in zip(prompts, urls):
print(f"{prompt[:40]}... → {url}")
asyncio.run(main())
Le cúig leid, in ionad fanacht go gcríochnaíonn gach iarratas sula seoltar an chéad cheann eile, ríomhtar na cúig íomhá go léir ag an am céanna: druideann an t-am iomlán le ham an iarratais is moille.
Rialú ar Chomhthreomhaireacht
Gan teorainn, seolann gather gach rud ar once—agus cruthaíonn caoga iarratas comhthreomhar ar mhúnla atá teoranta do 6 iarratas in aghaidh an tsoicind ag an leibhéal iontrála tuile earráidí 429 a chosnaíonn níos mó ama ort ná feidhmiú seicheamhach. Dá bhrí sin, ní réamhchúram roghnach é an seafamar: is é an rud a dhéanann comhthreomhaireacht inúsáidte é. Calabraigh é de réir teorainn ráta an mhúnla, riamh de réir acmhainneacht do mheaisín.
async def generate_with_limit(prompts, max_concurrent=5):
"""Giníonn sé íomhánna le huasmhéid iarratas comhthreomhar."""
semaphore = asyncio.Semaphore(max_concurrent)
async def limited_generate(prompt):
async with semaphore:
return await generate_image(prompt)
tasks = [limited_generate(prompt) for prompt in prompts]
return await asyncio.gather(*tasks)
Léiríonn na bileoga oifigiúla do grok-imagine-image agus grok-imagine-image-2.0 6 iarratas in aghaidh an tsoicind ag an leibhéal iontrála, teorainn a fhásann le leibhéal do fhoirne suas go 100. Nóta: cuireann seafamar teorainn le hiarratais chomhthreomhara, ní le tréchur. Le max_concurrent=5, fanann tú faoi bhun 6 iarratas in aghaidh an tsoicind fad is a mhaireann gach giniúint níos mó ná soicind amháin; má thagann do fhreagairtí níos tapúla, spásáil na hiarratais freisin. Seiceáil teorainneacha do fhoirne sa chonsól xAI sula ndéanann tú méadú.
Píblíne Asincronach Iomlán
Slabhraíonn an phíblíne seo na trí oibríocht a chaithfidh dul le chéile: giniúint, íoslódáil láithreach—téann URLanna in éag—agus teiptheanna a aonrú. Ar bhaisc mhóra, déanann an tríú pointe seo an difríocht idir eachtra agus cailliúint iomlán.
import aiohttp
import aiofiles
async def download_image(session, url, filepath):
"""Íoslódálann sé íomhá go hasincronach."""
async with session.get(url) as resp:
if resp.status == 200:
async with aiofiles.open(filepath, "wb") as f:
await f.write(await resp.read())
return filepath
return None
async def pipeline(prompts, output_dir="output"):
"""Píblíne iomlán: giniúint + íoslódáil."""
os.makedirs(output_dir, exist_ok=True)
# Céim 1: gínigh gach íomhá go comhthreomhar
urls = await generate_with_limit(prompts, max_concurrent=5)
# Céim 2: íoslódáil gach íomhá go comhthreomhar
async with aiohttp.ClientSession() as session:
download_tasks = []
for i, url in enumerate(urls):
if url:
# JPEG de réir réamhshocraithe (image/jpeg), mura dtáirgeann socruithe cáilíochta PNG
filepath = os.path.join(output_dir, f"image_{i:03d}.jpg")
download_tasks.append(download_image(session, url, filepath))
saved_files = await asyncio.gather(*download_tasks)
count = sum(1 for f in saved_files if f)
print(f"{count}/{len(prompts)} íomhánna ginte agus sábháilte")
Comparáid idir Sioncronach agus Asincronach
Ríomhtar an gnóthachan ar pháipéar. Má thógann giniúint amháin T soicind, tógann fiche íomhá a iarrtar ceann i ndiaidh a chéile thart ar 20 × T. Le cúig iarratas comhthreomhar, téann siad i dtonnta de chúigear: thart ar 4 × T, gnóthachan atá gar do chúig, líon na n-iarratas comhthreomhar—faoi choinníoll go bhfanann tú faoin teorainn tréchurtha. Tomhais T ar do chuntas féin sula ngeallann tú spriocdháta: ní thugann leathanaigh íomhá xAI aon am giniúna, agus athraíonn sé de réir an mhúnla, an taifigh agus an ualaigh.
Láimhseáil Earráidí
Is brúidiúil iompraíocht réamhshocraithe gather: má tharlaíonn eisceacht in aon tasc amháin, brúchtann an earráid aníos agus cailleann tú torthaí na dtascanna eile, fiú na cinn a íocadh cheana féin. Athraíonn return_exceptions=True é sin—filleann gach tasc either a thoradh nó a eisceacht, agus is tusa a chinneann cad a dhéanann tú le teipeanna gan rathanna a íobairt.
async def safe_generate(prompt):
"""Giníonn sé íomhá le láimhseáil earráidí."""
try:
return await generate_image(prompt)
except Exception as e:
print(f"Earráid do '{prompt[:30]}...' : {e}")
return None
Príomhphointí
- Cumasaíonn an cliant
AsyncOpenAIiarratais chomhthreomhara tríasyncio - Úsáid
asyncio.gatherchun iliomad giniúintí a sheoladh ag an am céanna - Teorainnigh comhthreomhaireacht le seafamar chun teorainneacha ráta a urramú
- Druideann an gnóthachan le líon na n-iarratas comhthreomhar, laistigh den teorainn tréchurtha údaraithe (6 iarratas in aghaidh an tsoicind ag an leibhéal iontrála)
- Láimhseáil earráidí go hindibhidiúil chun an baisc iomlán a sheachaint