Móidearálú, neamh-chomhoiriúnacht SDK, agus rialú costais
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026 — Imagine. Baineadh
grok-imagine-image-qualityan 2 Samhain, 2026 (freastalaítear ar a iarratais ag Imagine 2.0 i gcáilíochtlow): úsáideann na samplaí anoisgrok-imagine-image(Imagine 1.0) agusgrok-imagine-image-2.0(Imagine 2.0, cáilíochtlow,medium, nóauto). Leis an OpenAI SDK, téannaspect_ratio,resolution, agusqualitytríextra_body, agus téann eagarthóireacht trí xAI SDK nó trí iarratas HTTP.
Tuiscint a fháil ar theorainneacha an API íomhá
Chun feidhmchláir iontaofa a thógáil le API giniúna íomhánna Grok, ní mór duit a theorainneacha a bheith ar eolas agat: móidearálú uathoibríoch, neamh-chomhoiriúnacht le modhanna áirithe OpenAI SDK, agus meicníochtaí rialaithe costais.
Móidearálú ábhair
Déanann an API móidearálú uathoibríoch ar leideanna (prompts) agus ar íomhánna ginte. Diúltaítear do chineálacha áirithe ábhair:
- Ábhar atá foréigneach nó folaíoch go follasach
- Ábhar gnéasach go follasach
- Ábhar fuathach nó idirdhealaitheach
- Ábhar a bhaineann le mionaoisigh ar bhealach míchuí
Nuair a spreagtar móidearálú, seolann an API earráid in ionad íomhá.
Láimhseáil diúltuithe móidearálaithe
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Gin íomhá agus láimhseáil diúltuithe móidearálaithe."""
try:
response = requests.post(
"https://api.x.ai/v1/images/generations",
headers=headers,
json={"model": "grok-imagine-image", "prompt": prompt, **kwargs}
)
response.raise_for_status()
return response.json()["data"][0]["url"]
except requests.exceptions.HTTPError as e:
if response.status_code == 400:
print(f"Diúltaíodh don leid de bharr móidearálaithe: {prompt[:50]}...")
return None
raise
Dea-chleachtais mhóidearálaithe
Go praiticiúil, déileáil le móidearálú roimh ré seachas go himoibríoch. Má bhloctar leid dlisteanach, déan athruithe a thástáil chun an focal spreagtha a aithint—rachaidh “cath eipiciúil” tríd nuair nach rachaidh téarma garbh, agus seachnaíonn mapáil na íogaireachtaí seo bacainní athfhillteacha. Nuair a thagann leideanna ó d’úsáideoirí, cuir réamhscagaire taobh freastalaí leis roimh an nglaoch API: gabhann sé iarratais atá go soiléir lasmuigh den bheartas gan iarratas a chaitheamh, agus coinníonn sé an smaoineamh agatsa ar an teachtaireacht a thaispeántar. Toisc go ndéanann an pointe deireanach seo an difríocht sa taithí: níor chóir go sroichfeadh bloc móidearálaithe an t-úsáideoir riamh mar earráid theicniúil amh, ach mar theachtaireacht shoiléir—“níl an t-iarratas seo i gcomhréir lenár rialacha inmheánacha”—a mhíníonn gan sonraí an API a nochtadh.
Neamh-chomhoiriúnacht OpenAI SDK le haghaidh eagarthóireachta
Is pointe ríthábhachtach é seo: ní oibríonn an modh images.edit() OpenAI SDK leis an xAI API. Seolann an OpenAI SDK sonraí mar multipart/form-data, ach tá application/json ag teastáil ón xAI API.
# NÍ OIBRÍONN SÉ SEO
from openai import OpenAI
client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")
client.images.edit(
model="grok-imagine-image",
image=open("photo.png", "rb"),
prompt="Edit this image"
)
# → Earráid Content-type!
# AG OIBRIÚ: glaoch REST díreach
import requests
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers={
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
},
json={
"model": "grok-imagine-image",
"prompt": "Edit this image",
"image": {"url": "https://exemple.com/photo.jpg"}
}
)
Achoimre comhoiriúnachta
| Oibríocht | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Comhoiriúnach | Comhoiriúnach |
| images.edit() | Neamh-chomhoiriúnach | Comhoiriúnach |
Rialú costais
Monatóireacht a dhéanamh ar ídiú
Cuir cuntair chaiteachais ar bun i do chód:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # cáilíocht íseal; meánach ag ráta greille
}
def __init__(self, budget_limit=10.0):
self.total_spent = 0.0
self.budget_limit = budget_limit
self.image_count = 0
def can_generate(self, model, n=1):
cost = self.PRICES[model] * n
return (self.total_spent + cost) <= self.budget_limit
def record(self, model, n=1):
cost = self.PRICES[model] * n
self.total_spent += cost
self.image_count += n
def report(self):
remaining = self.budget_limit - self.total_spent
print(f"Íomhánna ginte: {self.image_count}")
print(f"Caite: ${self.total_spent:.2f}")
print(f"Buiséad atá fágtha: ${remaining:.2f}")
# Úsáid
tracker = ImageBudgetTracker(budget_limit=5.0)
if tracker.can_generate("grok-imagine-image", n=5):
response = client.images.generate(
model="grok-imagine-image",
prompt="My image",
n=5
)
tracker.record("grok-imagine-image", n=5)
tracker.report()
Costais a bharrfheabhsú
Is é an riail órga ná taithí agus táirgeadh a scaradh ó chéile. Le linn cuardaigh leideanna, oibrigh le Imagine 1.0 ($0.02) le n=3-5 chun athruithe a chur i gcomparáid ag costas níos ísle; nuair atá an leid cobhsaí, athraigh go Imagine 2.0 le n=1 don render deiridh. Coimeádann an seicheamhú seo an ráta is airde do na híomhánna roghnaithe amháin.
Cuireann dhá mheicníocht críoch leis an socrú ar thaobh an fheidhmchláir. Ar dtús, taisce torthaí: má thagann an leid céanna ar ais—amharcanna catalóige, íomhánna caighdeánacha athghinte ag úsáideoirí iolracha—seirbhísigh an íomhá a gineadh cheana in ionad íoc as iarratas nua. Ansin cuótaí, má spreagann d’úsáideoirí giniúintí iad féin: cosnaíonn teorainn in aghaidh an lae nó na huaire do bhuiséad ó úsáid mhíréasúnach agus mí-úsáid. Ar deireadh, coinnigh súil ar theorainneacha ráta (300 RPM caighdeánach, 30 RPM pro): carnann píblíne baisce a dhéanann neamhaird orthu earráidí 429 agus iarrachtaí athdhéanta nach gá.
Meastachán buiséid míosúil
Do aip le 100 úsáideoir ag giniúint 10 íomhá in aghaidh an lae:
- Imagine 1.0: 100 x 10 x 30 x $0.02 = $600/mí
- Imagine 2.0 i
low: 100 x 10 x 30 x $0.04 = $1,200/mí - Measctha (80/20): 24,000 x $0.02 + 6,000 x $0.04 = $720/mí
Pointe deireadh chun múnlaí a aimsiú
Chun múnlaí íomhá atá ar fáil agus a bpraghsanna a sheiceáil go cláraithe:
response = requests.get(
"https://api.x.ai/v1/image-generation-models",
headers={"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}"}
)
for model in response.json()["data"]:
print(f"{model['id']} : ${model['image_price']}/íomhá, "
f"uasmhéid leide : {model['max_prompt_length']} carachtair")
Rátaí ón 5 Lúnasa, 2026 — athraíonn praghsanna go rialta: roimh aon ríomh buiséid, seiceáil an ghreille reatha ar leathanach oifigiúil múnlaí agus rátaí xAI.
Príomhphointí
- Tá móidearálú uathoibríoch: láimhseáil diúltuithe i do chód
- Níl
images.edit()OpenAI SDK comhoiriúnach le xAI: úsáidrequests - Oibríonn
images.generate()OpenAI SDK go gnáth - Cuir rianaire buiséid i bhfeidhm chun caiteachas a rialú
- Seiceáil múnlaí agus praghsanna tríd an bpointe deireadh
/v1/image-generation-models
Tástáil do chuid eolais
Giniúint agus eagarthóireacht íomhánna: an t-athbhreithniú oibríochtúil.
1. Cad a dhéanann idirdhealú idir Imagine 1.0 agus Imagine 2.0?
Freagra: An comhréir idir cáilíocht agus costas: Imagine 1.0 ($0.02) le haghaidh toirte agus atriallacha, Imagine 2.0 ($0.04 i low, le socruithe quality) le haghaidh renderanna deiridh—déanann tú samhaltú leis an gcéad cheann, agus críochnaíonn tú leis an dara ceann.
2. Cad a dhéanann leid íomhá maith?
Freagra: Ábhar, stíl, comhdhéanamh, agus sonraí sainráite—déan cur síos ar an radharc mar bhrífe treoracha ealaíne, ansin déan atriallacha le feabhsuithe spriocdhírithe seachas athscríobh.
3. Cad a cheadaíonn an pointe deireadh /v1/images/edits?
Freagra: Íomhánna atá ann cheana a chur in eagar: eagarthóireacht spriocdhírithe leideanna, eagarthóireacht il-íomhá le tagairtí, agus eagarthóireacht il-chas—déanann tú teagmháil go beacht in ionad athghiniúna.
4. Conas táirgeadh i dtoirt go héifeachtúil?
Freagra: An paraiméadar n le haghaidh baisceanna, an cliant async le haghaidh tréchur—agus ós rud é go bhfuil URLanna aschuir sealadach, íoslódáil agus cartlannaigh iad láithreach.
5. Cad iad na cosaintí roimh tháirgeadh?
Freagra: Móidearálú leideanna agus aschur, eolas ar neamh-chomhoiriúnachtaí SDK, agus rialú costais (múnla, taifeach, toirteanna)—éilíonn cruthú ar scála rialachas.
Déan samhaltú, cuir in eagar, tionsclaigh, rialaigh: an píblíne íomhá iomlán—le costais faoi smacht ag gach céim.