Salt la conținutul principal
Română— Alege o limbă
Meniu

API-ul de generare de imagini în 2026

Lecția 1 din 12 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. API-ul de generare de imagini în 2026
  2. Ce schimbă GPT Image
  3. Cele două endpoint-uri principale
  4. Instalare și configurare
  5. Model și prețuri
  6. Ce veți învăța

Actualizat la 2 noiembrie 2026 — Modele de imagini. gpt-image-1, modelul pentru care a fost scris inițial acest curs, a fost întrerupt la 23 octombrie 2026. În plus, gpt-image-1.5, gpt-image-1-mini și chatgpt-image-latest vor fi retrase la 1 decembrie 2026. Exemplele folosesc acum gpt-image-2.5-sunburst, care oferă cea mai mare precizie pentru editare; gpt-image-2.5-flare este mai rapid pentru generarea standard. Ambele modele suportă, de asemenea, setările de calitate xhigh și max. Modelele GPT Image returnează întotdeauna imagini în format base64: parametrul response_format de la modelele DALL·E mai vechi nu este suportat și a fost eliminat din cod. Sursă: Generare de imagini (OpenAI).

API-ul de generare de imagini în 2026

Generarea de imagini cu IA a evoluat semnificativ. În 2026, GPT Image este modelul de referință OpenAI pentru crearea și editarea imaginilor prin API; acesta înlocuiește modelele acum învechite DALL·E 2 și DALL·E 3. Dacă aveți cod existent pentru aceste generații anterioare, tratați-l ca pe un punct de plecare pentru o rescriere, nu ca pe o fundație de păstrat: parametrii, formatele de returnare și, în special, strategiile de inginerie a prompturilor s-au schimbat toate.

Această lecție introduce ecosistemul actual, capacitățile GPT Image și modul în care veți interacționa cu API-ul pe parcursul acestui curs.

Ce schimbă GPT Image

Prima schimbare majoră privește textul. Generațiile anterioare produceau litere aproximative, decorative, dar ilizibile; GPT Image randează o tipografie fidelă, făcând în final viabile afișele, bannerele promoționale și machetele de interfață acolo unde mesajul contează la fel de mult ca imaginea. A doua schimbare vizează înțelegerea contextuală: modelul interpretează instrucțiuni complexe cu nuanțe, astfel încât un prompt format din mai multe propoziții care descriu o scenă, iluminarea și încadrarea acesteia produce un rezultat coerent, nu un colaj de cuvinte-cheie.

Urmează editarea nativă. Nu mai porniți sistematic de la o pagină albă: modelul poate modifica o imagine existentă prin înlocuirea unei zone interioare (inpainting) sau prin extinderea imaginii dincolo de marginile sale (outpainting). Practic, schimbarea cerului într-o fotografie de peisaj nu mai necesită regenerarea întregii imagini și pierderea subiectului în proces. La acestea se adaugă consistența stilistică menținută pe parcursul generărilor succesive – valoroasă atunci când produceți o serie de ilustrații pentru același articol – și multiple opțiuni de rezoluție, de la formate pătrate la portret și peisaj.

Cele două endpoint-uri principale

API-ul expune două metode, pe care le veți explora în profunzime în lecțiile următoare. Prima creează o imagine dintr-o descriere textuală.

import base64
from openai import OpenAI

client = OpenAI()

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="A Breton lighthouse at sunset, watercolor style",
    n=1,
    size="1024x1024"
)

with open("lighthouse.png", "wb") as f:
    f.write(base64.b64decode(response.data[0].b64_json))

A doua preia o imagine furnizată de dumneavoastră și regenerează doar partea desemnată de o mască.

response = client.images.edit(
    model="gpt-image-2.5-sunburst",
    image=open("original_photo.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="Replace the sky with a starry sky"
)

Instalare și configurare

Instalați mai întâi SDK-ul oficial.

pip install openai

Apoi, plasați cheia API într-un fișier .env, niciodată hard-codată în scriptul dumneavoastră: un script partajat sau unul împins într-un repository v-ar expune cheia.

OPENAI_API_KEY=sk-your-api-key

Clientul o preia apoi automat la pornire, fără ca dumneavoastră să fie nevoie să o transmiteți ca argument.

import os
from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()
client = OpenAI()  # utilizează automat OPENAI_API_KEY

Model și prețuri

Modelele actuale sunt gpt-image-2.5-sunburst, cel mai precis pentru editare, și gpt-image-2.5-flare, mai rapid pentru generarea standard; gpt-image-1, modelul pentru care a fost scris inițial acest curs, a fost întrerupt la 23 octombrie 2026. Iată caracteristicile pe care le veți gestiona constant.

ParametruValoare
Modelgpt-image-2.5-sunburst sau gpt-image-2.5-flare
Rezoluții1024×1024, 1024×1536, 1536×1024 recomandate; dimensiuni personalizate posibile (multipli de 16, până la 3840 pixeli pe latură)
Calitățilow, medium, high, xhigh, max, auto (implicit)
Formate de ieșireImagine codificată Base64, PNG (implicit), JPEG sau WebP
PrețuriPer token, variază în funcție de calitate și dimensiune

Rețineți un aspect care îi surprinde pe veteranii DALL·E: modelele GPT Image nu returnează niciodată un URL, ci întotdeauna o imagine codificată base64. Decodificați-o și salvați fișierul imediat după generare; aplicația dumneavoastră stochează și servește acest fișier, nu răspunsul API.

Ce veți învăța

Cursul progresează în patru etape. Începeți cu fundamentalele GPT Image prin API – generare și editare – înainte de a trece la cazuri de utilizare concrete în e-commerce, marketing și design. Tehnicile avansate vă vor învăța apoi să construiți prompturi vizuale complexe și să integrați generarea în pipeline-uri cu multiple instrumente. Partea finală acoperă implementarea în producție, inclusiv optimizarea costurilor și moderarea conținutului. Fiecare lecție conține cod Python funcțional pe care îl puteți rula direct.

Înainte de a merge mai departe, verificați dacă mediul dumneavoastră este pregătit. Rulați acest script minimal: dacă apare un fișier imagine, cheia dumneavoastră este validă, SDK-ul este instalat corect și puteți trece la lecția următoare.

import base64
from openai import OpenAI

client = OpenAI()

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="A ginger cat sitting on a pile of books, realistic photo",
    n=1,
    size="1024x1024",
    quality="medium"
)

with open("cat.png", "wb") as f:
    f.write(base64.b64decode(response.data[0].b64_json))

print("Image generated: cat.png")