Mafunzo ya AI

Tengeneza Picha kwa GPT Image 2.5 Kupitia API ya APIMart

Jifunze jinsi ya kuita GPT Image 2.5 kupitia API ya picha ya APIMart isiyosawazisha. Mafunzo haya yanaangazia uteuzi wa modeli, usanidi wa API, mifano ya curl na Python, ufuatiliaji wa kazi, uundaji wa vidokezo, picha za marejeo, ukaguzi wa bei, majaribio ya tena, na ushughulikiaji wa URL za matokeo za muda unaofaa kwa mazingira ya uzalishaji.

20 Septemba 2026Takriban dakika 27 za kusoma

Tengeneza Picha kwa GPT Image 2.5 Kupitia API ya APIMart

Kile Mradi Huu Unatoa

Jumba la Prompts la image2.5 ni mkusanyiko wa vitendo wa prompts 12 zilizotumika kupitia GPT Image 2.5 na kuchapishwa pamoja na picha zilizotokana nazo. Kila kichocheo huhifadhi prompt, toleo la modeli, uwiano wa vipimo na matokeo, hivyo kurahisisha kutathmini prompt kabla ya kuibadilisha kwa matumizi yako mwenyewe.

Mifano inatumia endpoint inayooana na OpenAI ya APIMart katika https://api.apimart.ai/v1. Njia inayopitishwa ni ya asinchronasi: programu yako hutuma ombi la picha, hupokea kitambulisho cha kazi, hufuatilia endpoint ya kazi, kisha hupakua picha baada ya uchakataji kukamilika.

Mfano wa picha iliyotengenezwa katika jumba la GPT Image 2.5

Sifa Muhimu

Njia ya uzalishaji inayoendana na OpenAI: maombi hutumwa kwa POST /v1/images/generations.
Tofauti mbili za njia iliyopitishwa: tumia version: "flare" kwa uzalishaji wa kawaida au version: "sunburst" kwa uhariri na kazi zinazoongozwa na marejeleo.
Viwango kadhaa vya matokeo: chagua 1K, 2K au 4K.
Uwekaji wa fremu unaobadilika: tumia auto au mojawapo ya uwiano kumi unaotumika, ikiwemo 1:1, 16:9, 9:16 na 4:3.
Matokeo ya kundi: omba picha moja hadi nne kwa kutumia n.
Msaada wa picha za marejeleo: toa hadi URL 16 au data URL katika image_urls.
Ripoti ya gharama kwa kila ombi: data ya kazi iliyokamilika inajumuisha cost na credits_cost.
Marudio yasiyozalisha nakala: API inakubali kichwa cha Idempotency-Key kusaidia kuzuia kazi kurudiwa unapotuma tena ombi lilelile.

Chagua Njia Sahihi ya Modeli

APIMart hutoa njia za GPT Image 2.5 zilizopitishwa na rasmi. Sehemu zao za ombi na mifumo ya utozaji ni tofauti, kwa hiyo chagua njia kabla ya kuandika muunganisho wako.

Njia iliyopitishwa ya kutoza kwa kila picha

Weka model kuwa gpt-image-2.5-ext na ujumuishe ama version: "flare" au version: "sunburst". Hii ndiyo njia inayotumiwa na mifano ya jumba na hutozwa kwa kila picha inayowasilishwa.

flare: inafaa kwa uzalishaji wa kawaida na rasimu za makundi.
sunburst: inafaa kwa usahihi wa uhariri na kazi zinazopaswa kuhifadhi marejeleo, vitu, nembo au lebo za bidhaa.

Njia rasmi ya kutoza kwa tokeni

Tumia gpt-image-2.5-flare au gpt-image-2.5-sunburst moja kwa moja. Usitume sehemu ya version pamoja na vitambulisho hivi vya modeli. Njia rasmi hutozwa kwa tokeni na ina viwango vya ubora kuanzia low hadi max, pamoja na vipimo kamili vya pikseli.

Usichanganye miundo ya njia. Jina mbadala gpt-image-2.5-ext linahitaji kiteuzi cha toleo, huku vitambulisho rasmi vya modeli havipaswi kujumuisha kiteuzi hicho.

Usakinishaji na Usanidi

1. Fungua na uweke fedha kwenye akaunti

Pata ufunguo wa API kutoka ukurasa wa funguo wa APIMart. Kulingana na hifadhi ya msimbo, huduma haina kiasi cha bure na inaunga mkono kuweka fedha kuanzia $1.

2. Hifadhi ufunguo katika kigezo cha mazingira

export APIMART_API_KEY="your-api-key"

Epuka kuweka ufunguo moja kwa moja katika msimbo wa programu au kuuhifadhi kwenye mfumo wa udhibiti wa matoleo.

3. Sakinisha utegemezi wa Python

Mfano wa Python hutumia kifurushi cha wahusika wengine cha requests.

python -m pip install requests

Ukipendelea curl, hakikisha kuwa curl na jenereta ya UUID kama uuidgen zinapatikana kwenye shell yako.

Tengeneza Ombi Lako la Kwanza la Picha kwa curl

Ombi lifuatalo huunda picha ya mraba ya 1K kwa kutumia tofauti ya flare iliyopitishwa:

IDEMPOTENCY_KEY="$(uuidgen)"
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --header "X-APIMart-Response-Version: 2026-07-27" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data '{
    "model": "gpt-image-2.5-ext",
    "version": "flare",
    "prompt": "A cozy reading nook beside a window on a rainy day, warm table lamp, cinematic lighting",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Uwasilishaji uliofanikiwa hurudisha HTTP 202. Soma kitambulisho cha kazi kutoka data.id au tumia data.poll_url iliyorudishwa.

Fuatilia kazi

curl --request GET \
  --url "https://api.apimart.ai/v1/tasks/TASK_ID" \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "X-APIMart-Response-Version: 2026-07-27"

Kazi kwa kawaida hutoka pending hadi processing, kisha hukamilika ikiwa completed au failed. Inapokamilika, pata URL za picha zilizotengenezwa kutoka result.images[].url.

URL za picha zilizotengenezwa zina muhuri wa muda wa expires_at. Pakua na uhifadhi kila faili kabla URL yake haijaisha muda.

Mfano wa picha iliyotengenezwa kutoka kwenye jumba la prompts

Jenga Mteja wa Python wa Mwisho hadi Mwisho

Mfano huu hutuma ombi moja, hukagua hitilafu za HTTP, hufuatilia kila baada ya sekunde tano na kurudisha rekodi ya kazi iliyokamilika. Huunda ufunguo mpya wa kuzuia marudio kwa kila uzalishaji mpya.

import os
import time
import uuid
import requests

BASE_URL = "https://api.apimart.ai/v1"
API_KEY = os.environ["APIMART_API_KEY"]

COMMON_HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "X-APIMart-Response-Version": "2026-07-27",
}

def generate_image(prompt, version="flare", resolution="1K", size="1:1"):
    submit_headers = {
        **COMMON_HEADERS,
        "Idempotency-Key": str(uuid.uuid4()),
    }

    response = requests.post(
        f"{BASE_URL}/images/generations",
        headers=submit_headers,
        timeout=60,
        json={
            "model": "gpt-image-2.5-ext",
            "version": version,
            "prompt": prompt,
            "size": size,
            "resolution": resolution,
            "n": 1,
        },
    )
    response.raise_for_status()
    task_id = response.json()["data"]["id"]

    while True:
        poll_response = requests.get(
            f"{BASE_URL}/tasks/{task_id}",
            headers=COMMON_HEADERS,
            timeout=60,
        )
        poll_response.raise_for_status()
        task = poll_response.json()["data"]

        if task["status"] == "completed":
            return task
        if task["status"] == "failed":
            raise RuntimeError(f"Generation failed: {task}")

        time.sleep(5)

result = generate_image(
    "Studio product hero of a matte ceramic espresso cup on a warm stone pedestal, soft window light, 85mm lens look, minimal beige backdrop, crisp shadow"
)

print("Cost:", result.get("cost"))
for image in result["result"]["images"]:
    print("Image URL:", image["url"])
    print("Expires at:", image.get("expires_at"))

Jaribu tena kwa usalama

Ikiwa uwasilishaji utaisha muda au utapokea jibu linaloweza kujaribiwa tena, tuma tena ombi lilelile la kimantiki ukitumia Idempotency-Key ileile. Tumia ufunguo mpya unapokusudia kuunda picha mpya. Ikiwa kazi iliyokamilika lazima iundwe upya kwa sababu chanzo au marejeo yake yamebadilika, pia tumia ufunguo mpya.

Elewa Sehemu Kuu za Ombi

model: inahitajika; tumia gpt-image-2.5-ext kwa njia iliyopitishwa.
version: flare au sunburst; chaguo-msingi ni flare.
prompt: inahitajika na lazima iwe na maandishi yasiyo ya nafasi tupu.
resolution: 1K, 2K, au 4K; chaguo-msingi ni 1K.
size: chaguo-msingi ni auto. Uwiano unaotumika ni 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, na 21:9.
n: idadi ya picha, kutoka moja hadi nne kwenye njia iliyopitishwa.
image_urls: safu ya hiari iliyo na hadi URL 16 za picha au URL za data.

Andika Maagizo Yanayotegemeka Zaidi

Jumba la picha huchukulia agizo kama muhtasari mfupi wa uzalishaji badala ya orodha ya vivumishi visivyoeleweka. Muundo unaofaa ni mada, nyenzo, mwangaza, upangaji au lenzi, na umalizio.

Taja mada: bainisha kitu, mtu, mandhari au mazingira makuu.
Eleza nyenzo halisi: tumia vifungu kama matte ceramic, frosted glass, au clay render.
Weka mwangaza: eleza mwangaza laini wa dirishani, mwangaza wa asili wa pembeni, mwangaza wa studio wenye mwanga mwingi, au mwangaza mkali wa nyuma.
Weka mpangilio: taja muundo uliowekwa katikati, mwonekano wa juu wa vitu vilivyopangwa tambarare, muundo mpana wa sinema, au mpangilio mwingine unaokusudiwa.
Ongeza istilahi za lenzi: maneno kama 85mm, 24mm, macro, na focus stacked yanaweza kuelekeza mtazamo na maelezo.
Chagua umalizio: vifungu kama maelezo ya kimchoraji, upigaji picha wa kibiashara wa bidhaa, au kingo safi za vekta hudhibiti mwonekano wa picha.

Kwa mfano:

Cosmetics packshot of a frosted glass bottle with amber serum,
water droplets on the surface, seamless pale pink backdrop,
high detail commercial product photography

Picha ya jumba la maagizo inayoonyesha utengenezaji wenye mtindo

Tumia Picha za Marejeo

Kwa kazi ya picha-kwa-picha au kazi inayoongozwa na marejeo, ongeza safu ya image_urls kwenye ombi lililopitishwa. Njia hii inakubali hadi marejeo 16.

{
  "model": "gpt-image-2.5-ext",
  "version": "sunburst",
  "prompt": "Preserve the product and label, replace the background with soft off-white, and add a natural cast shadow",
  "image_urls": [
    "https://example.com/product-reference.jpg"
  ],
  "size": "1:1",
  "resolution": "2K",
  "n": 1
}

Tumia URL za marejeo zilizo thabiti na zinazoweza kufikiwa. Ikiwa kazi itashindwa kwa sababu URL ya rejeo imekwisha muda, pakia picha hiyo tena mahali pengine na utume kazi mpya ukitumia ufunguo mpya wa idempotency.

Piga Njia Rasmi

Njia rasmi hutumia kitambulisho cha moja kwa moja cha modeli na mipangilio ya quality badala ya kiteuzi cha version cha njia iliyopitishwa.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "Preserve the product label, replace the background with soft off-white, add a natural cast shadow",
    "size": "1:1",
    "resolution": "1k",
    "quality": "high",
    "n": 1
  }'

Angalia nyaraka za njia rasmi na nyaraka za njia ya relay kwa maelezo ya sasa ya sehemu.

Vidokezo vya Juu vya Uzalishaji

Tenganisha uwasilishaji na uchakataji

Hifadhi kitambulisho cha kazi kilichorejeshwa kwenye foleni au hifadhidata badala ya kuacha ombi la wavuti likiwa wazi. Mfanyakazi wa chinichini anaweza kuulizia kazi ambazo hazijakamilika na kuhifadhi matokeo yaliyokamilika.

Tumia vipindi vya wastani vya kuulizia

Mifano ya hazina huulizia kila baada ya sekunde tano. Epuka mizunguko mifupi inayozalisha trafiki isiyo ya lazima. Kwa mizigo mikubwa, ongeza muda wa kusubiri kila kazi ikiwa bado inasubiri au inachakatwa.

Rekodi gharama halisi

Hifadhi cost au credits_cost kutoka kwa kila kazi iliyokamilika. Hii hukupa rekodi ya matumizi kwa kila mwito badala ya kutegemea makadirio pekee.

README inaripoti bei iliyozingatiwa ya njia ya relay ya $0.0085 kwa kila picha ya 1K iliyowasilishwa, $0.014 kwa 2K, na $0.021 kwa 4K flare. Bei ya 4K sunburst haikuwekwa kwenye jedwali. Takwimu hizi ziliwekwa tarehe ya uchunguzi Septemba 2026, kwa hiyo angalia bei za moja kwa moja kabla ya kupanga bajeti au kuongeza kiwango.

Pakua matokeo mara moja

Usichukulie result.images[].url kama hifadhi ya kudumu. Pakua faili kabla ya expires_at, kisha ihamishe kwenye hifadhi inayodhibitiwa na programu yako.

Anza kidogo kabla ya kuongeza kiwango

Thibitisha mwongozo kwenye 1K ukiwa na n: 1. Ongeza mwonekano au omba matokeo mengi tu baada ya mada, mpangilio na mtindo kuwa thabiti.

Linganishia uwiano wa pande na matumizi yaliyokusudiwa

1:1 kwa aikoni, kadi za bidhaa na nyenzo za mitandao ya kijamii zenye umbo la mraba.
16:9 kwa mandhari za sinema, dashibodi na vichwa vya mawasilisho.
9:16 kwa mipangilio ya wima ya simu na mitandao ya kijamii.
4:3 kwa vielelezo vya uhariri na upigaji picha wa vyakula.
3:4 kwa picha za watu na miundo ya mitindo.

Mfano wa ziada wa matokeo ya GPT Image 2.5

Kutatua Matatizo

401 au ufunguo batili wa API: nakili ufunguo tena na uhakikishe hakuna nafasi au herufi za mstari mpya. Kichwa lazima kitumie Authorization: Bearer $APIMART_API_KEY.
Kosa la salio au mikopo: ongeza fedha kwenye akaunti; hazina inasema hakuna mgao wa bure wa akiba.
Jibu la 429: punguza miito ya wakati mmoja, ongeza muda wa kusubiri, na ujaribu tena uwasilishaji huohuo kwa kutumia ufunguo huohuo wa kutorudia.
400 au modeli haikupatikana: thibitisha kuwa gpt-image-2.5-ext ina toleo na kwamba vitambulisho rasmi vya modeli ya moja kwa moja havina toleo.
Hali ya kazi ni failed: kagua ikiwa mwongozo ulikataliwa au URL ya rejeleo iliisha muda. Sahihisha ingizo na uwasilishe kazi mpya kwa ufunguo mpya.
URL ya matokeo haifanyi kazi tena: huenda URL ya muda imeisha muda. Matokeo yaliyokamilika baadaye yanapaswa kupakuliwa haraka.

Hitimisho

Prompt Gallery ya image2.5 inaonyesha mtiririko wa kazi unaoweza kurudiwa wa kuunda nyenzo kwa GPT Image 2.5: chagua njia sahihi, andika mwongozo wa mtindo wa uzalishaji, wasilisha ombi lisilosawazisha, ulizia kitambulisho chake cha kazi, rekodi gharama iliyoripotiwa, na pakua matokeo kabla ya kuisha muda. Anza na picha moja ya 1K, thibitisha ubora na bili, kisha panua hadi mionekano ya juu zaidi, makundi, au mitiririko ya sunburst inayoongozwa na marejeleo.