Tengeneza na Hariri Picha kwa GPT-Image-2.5 Kupitia APIMart

Lango la image2.5 APIMart hufanya nini

Lango la image2.5 hutoa ufikiaji wa familia ya GPT Image 2.5 ya kuunda na kuhariri picha kupitia API ya APIMart. Badala ya kuunganisha kitambulisho na muundo tofauti wa ombi kwa kila modeli ya picha, unatumia URL moja ya msingi, tokeni moja ya bearer, na endpoint ya mtindo wa OpenAI /v1/images/generations.

API hii hufanya kazi kwa njia isiyosawazishwa. Ombi la uundaji hurudisha kitambulisho cha kazi badala ya picha moja kwa moja. Kisha programu yako hufuatilia endpoint ya kazi hadi uchakataji ukamilike au ushindwe. Kazi zilizofaulu huwa na URL za muda za matokeo, ambazo zinapaswa kupakuliwa kabla hazijaisha muda.

APIMart ndiyo huduma iliyoandikwa kwenye hazina. Endpoint ya gpt-image-2.5-ext ni njia ya uelekezaji ya mhusika wa tatu, huku gpt-image-2.5-flare na gpt-image-2.5-sunburst zikiwa njia zinazotoza kwa tokeni. Thibitisha vikomo na bei za sasa kabla ya kuendesha kazi ya uzalishaji.

Vipengele muhimu

• URL moja ya msingi ya API: Maombi hutumia https://api.apimart.ai/v1.
• Tofauti mbili za modeli: Chagua Flare kwa uundaji wa kila siku na rasimu za kundi, au Sunburst kwa usahihi wa uhariri na vipengee vinavyolenga uzalishaji.
• Njia mbili za utozaji: Njia iliyoelekezwa hutoza kwa kila picha iliyowasilishwa, huku njia rasmi zikitumia utozaji wa tokeni.
• Uchakataji usio sawazishwa: Tuma ombi na ufuatilie GET /v1/tasks/{task_id} ili kuona maendeleo.
• Viwango mbalimbali vya matokeo: Njia iliyoelekezwa inaauni 1K, 2K, na 4K.
• Mipangilio inayobadilika: Chagua kati ya uwiano wa vipengele kumi au tumia auto.
• Uundaji unaoongozwa na marejeo: Toa hadi maingizo 16 katika image_urls kwa kazi ya picha-kwa-picha au uhariri.
• Makundi madogo: Omba kati ya picha moja na nne zitakazowasilishwa kwa kutumia n kwenye njia iliyoelekezwa.

Chagua njia sahihi ya modeli

Njia iliyoelekezwa inayotoza kwa kila picha

Tumia model: "gpt-image-2.5-ext" unapotaka utozaji thabiti kwa kila picha iliyowasilishwa. Chagua tofauti ya msingi kwa kutumia version: "flare" au version: "sunburst".

• flare inalenga uundaji wa kiwango kikubwa, picha za kila siku, na rasimu.
• sunburst inalenga uhariri na kazi za uzalishaji zinazoongozwa na marejeo.

Hazina iliona bei ya $0.0085 kwa kila picha ya 1K iliyowasilishwa kwa tofauti zote mbili tarehe September 16, 2026. Pia ilirekodi $0.014 kwa 2K, $0.021 kwa 4K Flare, na kushauri kuangalia bei ya moja kwa moja ya 4K Sunburst. Hizi ni bei zilizorekodiwa kwa tarehe hiyo, si dhamana za kudumu.

Njia rasmi zinazotoza kwa tokeni

Tumia gpt-image-2.5-flare au gpt-image-2.5-sunburst moja kwa moja kwa utozaji wa tokeni. Njia hizi hazitumii sehemu ya version na zinaunga mkono viwango vya ubora vya low, medium, high, xhigh, na max. Njia rasmi pia inaauni vipimo kamili vya pikseli.

Kanuni ya vitendo ni kutumia njia iliyoelekezwa wakati gharama inayotabirika kwa kila picha ni muhimu, na kuzingatia njia rasmi wakati vidhibiti vyake vya ubora au vipimo kamili vinahitajika.

Mfano wa aina ya matokeo

Hazina inaonyesha vidokezo vya maombi kwa upigaji picha wa bidhaa, picha za watu, usanifu, vipengee vya UI, vielelezo, sanaa za michezo, upigaji picha wa chakula, na picha za karibu sana. Picha zifuatazo zilizotolewa zinaonyesha aina ya matokeo ya kuona iliyojumuishwa kwenye mradi.

Usakinishaji na usanidi

1. Unda ufunguo wa API

Pata ufunguo kutoka ukurasa wa funguo za API wa APIMart. Uuhifadhi katika kigezo cha mazingira badala ya kuuweka moja kwa moja kwenye msimbo wa chanzo.

export APIMART_API_KEY="your-api-key"

2. Chagua mteja

cURL haihitaji utegemezi wa mradi zaidi ya usakinishaji wa kawaida wa mstari wa amri. Kwa mfano wa Python, sakinisha kifurushi cha requests:

python -m pip install requests

Hazina pia inajumuisha mfano wa JavaScript kwa Node.js 18 au mpya zaidi, ambapo fetch inapatikana kimataifa.

3. Elewa vichwa vya ombi

Tuma ufunguo wa API katika kichwa cha Authorization. Mifano ya njia iliyoelekezwa pia hutumia kichwa cha toleo la jibu na ufunguo wa kipekee wa idempotency.

• Authorization: Bearer $APIMART_API_KEY
• Content-Type: application/json
• X-APIMart-Response-Version: 2026-07-27
• Idempotency-Key: unique-request-value

Tumia tena ufunguo huo wa idempotency unapojaribu tena uwasilishaji uleule. Unda ufunguo mpya unapokusudia kuunda kazi mpya ya picha.

Matumizi ya msingi: unda picha kwa cURL

Ombi lifuatalo linatumia njia ya kila picha, linachagua Flare, na linaomba picha moja ya mraba ya 1K:

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": "Sehemu ya starehe ya kusomea karibu na dirisha siku ya mvua, taa ya meza yenye mwanga wa joto, mwangaza wa sinema",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Ombi lililowasilishwa kwa mafanikio hurudisha HTTP 202. Soma kitambulisho cha kazi kutoka data.id au tumia data.poll_url iliyorejeshwa.

Fuatilia kazi

Badilisha task_01EXAMPLE kwa kitambulisho cha kazi kilichorejeshwa:

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

Hali ya kazi hupitia pending na processing kabla ya kufikia completed au failed. Jibu linaweza pia kuripoti progress, cost, na credits_cost. Ikikamilika, pata URL ya picha kutoka result.images[].url na kagua expires_at.

Mfano wa Python wa mwanzo hadi mwisho

Mfano huu unatuma picha moja na kukagua kazi kila baada ya sekunde tano hadi ifikie hali ya mwisho:

import os
import time
import uuid
import requests

BASE_URL = "https://api.apimart.ai/v1"
COMMON_HEADERS = {
    "Authorization": f"Bearer {os.environ['APIMART_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,
        json={
            "model": "gpt-image-2.5-ext",
            "version": version,
            "prompt": prompt,
            "size": size,
            "resolution": resolution,
            "n": 1,
        },
        timeout=60,
    )
    response.raise_for_status()
    task_id = response.json()["data"]["id"]

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

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

        time.sleep(5)

result = generate_image(
    "Bustani ya angani wakati wa mapambazuko, upigaji picha wa usanifu",
    version="flare",
    resolution="1K",
    size="16:9",
)

for image in result["result"]["images"]:
    print(image["url"], image.get("expires_at"))

Kwa mteja wa uzalishaji, rudisha au hifadhi kitu kamili cha kazi ili uweze kuhifadhi maelezo ya gharama, maendeleo, muda wa kuisha na hitilafu badala ya kurudisha URL pekee.

Tumia picha za marejeleo kwa uhariri

Ili kufanya uzalishaji wa picha-kwa-picha au uhariri kwenye njia inayowasilishwa, ongeza safu ya image_urls. Inaweza kuwa na hadi URL 16 au URL za data. Hazina ya msimbo inasema kuwa picha za marejeleo haziongezi gharama tofauti kwenye njia hii.

{
  "model": "gpt-image-2.5-ext",
  "version": "sunburst",
  "prompt": "Hifadhi lebo ya bidhaa, badilisha mandharinyuma iwe nyeupe hafifu, na uongeze kivuli cha asili kinachoanguka",
  "image_urls": [
    "https://example.com/source-product.jpg"
  ],
  "size": "1:1",
  "resolution": "2K",
  "n": 1
}

Sunburst ni lahaja inayopendekezwa na hazina ya msimbo kwa usahihi wa uhariri na kazi inayoongozwa na marejeleo. Tumia URL zinazofikika au URL halali za data, na weka orodha ndani ya kikomo kilichoandikwa.

Marejeleo ya sehemu za ombi kwa njia inayowasilishwa

• model: Inahitajika. Weka gpt-image-2.5-ext.
• version: Inakubali flare au sunburst; chaguo-msingi ni Flare.
• prompt: Inahitajika na haipaswi kuwa tupu baada ya kuondoa nafasi za mwanzo na mwisho.
• resolution: Inakubali 1K, 2K, au 4K; chaguo-msingi ni 1K.
• size: Inakubali auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, au 21:9.
• n: Inakubali nambari kamili kutoka 1 hadi 4.
• image_urls: Safu ya hiari iliyo na hadi URL 16 za marejeleo au URL za data.

Kuita njia inayotoza kwa tokeni

Njia rasmi hutumia njia ileile ya uzalishaji lakini hubadilisha kitambulisho cha modeli, huondoa version, na kuongeza mpangilio wa ubora. Mfano huu huchagua Sunburst yenye ubora wa juu:

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": "Hifadhi lebo ya bidhaa, badilisha mandharinyuma iwe nyeupe hafifu, ongeza kivuli cha asili kinachoanguka",
    "size": "1:1",
    "resolution": "1k",
    "quality": "high",
    "n": 1
  }'

Rejelea marejeo ya njia rasmi na marejeo ya njia inayopitishwa kwa ufafanuzi wa sasa wa sehemu.

Vidokezo vya hali ya juu kwa miunganisho thabiti

1. Fanya majaribio ya kurudia yawe idempotent. Hifadhi ufunguo wa awali wa idempotency ikiwa uwasilishaji utapitwa na muda na huna uhakika kama kazi iliundwa. Ufunguo mpya unaweza kuunda uzalishaji mwingine wa kutozwa.
2. Chukulia upigaji kura kuwa mtiririko wa kawaida wa kazi. Shughulikia hali zote mbili za completed na failed. Epuka upigaji kura wa haraka; mfano wa hifadhi husubiri sekunde tano kati ya ukaguzi.
3. Tumia URL ya upigaji kura iliyorejeshwa. Jibu linajumuisha data.poll_url, ambayo huepusha kujenga upya mwisho wa kazi wewe mwenyewe.
4. Pakua matokeo mara moja. URL za picha zilizozalishwa ni za muda. Nakili kila matokeo kwenye hifadhi yako kabla ya muda wake wa expires_at kufika.
5. Rekodi gharama halisi. Hifadhi cost na credits_cost kutoka kwenye jibu la kazi. Hii hukuwezesha kulinganisha malipo yaliyoonekana na bei zilizochapishwa.
6. Thibitisha gharama kwa ombi moja la kulipia. Bei na uelekezaji wa ofa vinaweza kubadilika, kwa hivyo fanya jaribio dogo kabla ya kuzindua kundi kubwa.
7. Tumia njia inayofaa. Chagua njia inayopitishwa kwa malipo yanayotabirika kwa kila picha na makundi ya hadi picha nne. Chagua kitambulisho rasmi cha modeli wakati ngazi ya ubora au udhibiti sahihi wa pikseli ni muhimu.
8. Badilisha vibadala bila kuandika upya mteja. Kwenye njia inayopitishwa, badilisha version pekee kati ya flare na sunburst.
9. Linda vitambulisho vya kuingia. Weka ufunguo wa API kwenye vigezo vya mazingira au kidhibiti cha siri, na usiuweke kamwe kwenye msimbo wa upande wa kivinjari.

Hitimisho

Gateway ya picha ya APIMart image2.5 hutoa njia thabiti ya kufikia uzalishaji na uhariri wa GPT Image 2.5. Anza na gpt-image-2.5-ext na Flare kwa uzalishaji unaotabirika wa kiwango kikubwa, badilisha kwenda Sunburst kwa uhariri au kazi zinazoongozwa na marejeo, na tumia vitambulisho rasmi vya modeli wakati malipo kwa tokeni na vidhibiti vya ziada vya ubora vinafaa zaidi kwa kazi hiyo.

Mfumo muhimu wa muunganisho ni rahisi: tuma ombi la picha, hifadhi kitambulisho cha kazi kilichorejeshwa, piga kura hadi ikamilike, kagua gharama iliyoripotiwa, na pakua kila matokeo kabla URL yake ya muda haijaisha. Kabla ya kuongeza kiwango, kagua bei za sasa za APIMart na thibitisha njia uliyochagua kwa ombi dogo la kulipia.