Generazione di immagini GPT-Image-2

gpt-image-2 supporta generazione e modifica di immagini di riferimento per immagini di prodotto, bozze di poster, illustrazioni, materiali social, immagini ad alta risoluzione, trasferimento di stile e fusione di più riferimenti.

POST https://api.apihop.ai/openai/v1/images/generations

Autenticazione

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Avvio rapido

{
  "model": "gpt-image-2",
  "prompt": "A minimal black wireless earbud product poster on a white background, clean studio lighting, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "low"
}

Ambito del confronto dei prezzi

Le fasce di immagini 1K / 2K / 4K pubblicate da RequestBeam sono *prezzi di vendita RequestBeam*, non tariffe ufficiali fisse OpenAI per immagine. La documentazione dei prezzi OpenAI descrive costi per token di immagine/testo e livelli di elaborazione; il costo effettivo dipende da dimensioni, qualità, riferimenti di input e output. Confrontarli solo perché entrambi citano 1k o 2k non è un calcolo di sconto a parità di condizioni.

Per evitare promesse di risparmio non supportate, il vecchio riferimento aggregato dei fornitori USD per image e il badge di sconto sono intenzionalmente nascosti per GPT Image 2. Il prezzo RequestBeam resta visibile e il contratto di fatturazione non cambia. Per un confronto futuro difendibile, registra modello esatto, endpoint, qualità, dimensioni, condizioni di input, URL della fonte ufficiale e data di verifica del riferimento. Controlla il prezzo effettivo del tuo account prima di una chiamata a pagamento.

Corpo della richiesta

Immagini di riferimento e modifica

La modifica di immagini di riferimento usa lo stesso endpoint JSON. Aggiungi image_urls e descrivi in prompt cosa mantenere e cambiare:

{
  "model": "gpt-image-2",
  "prompt": "Keep the product unchanged, replace the background with a dark blue studio, and add soft rim lighting",
  "image_urls": [
    "https://example.com/product.png"
  ],
  "size": "1:1",
  "resolution": "2k"
}

Più riferimenti possono fornire soggetto, composizione o stile visivo:

{
  "model": "gpt-image-2",
  "prompt": "Use the product from the first image and the composition from the second image to create a clean ecommerce hero image",
  "image_urls": [
    "https://example.com/product.png",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ],
  "size": "4:3",
  "resolution": "2k"
}

Limiti attuali del contratto pubblico:

• Modifica dell’intera immagine, trasferimento di stile e fusione di più riferimenti sono supportati tramite image_urls.
• Non esiste una route separata POST https://api.apihop.ai/openai/v1/images/edits.
• I caricamenti multipart/form-data non sono accettati. Converti prima le immagini locali in URI dati Base64 o caricale su URL accessibili.
• L’inpainting con maschera non è supportato. Inviare mask, mask_url o maskUrl restituisce 400 prima della prenotazione.

Esempi di richiesta

Immagine di prodotto 1:1

{
  "model": "gpt-image-2",
  "prompt": "A transparent glass cup on a light gray background, commercial product photography, soft shadow, no text",
  "n": 1,
  "size": "1024x1024",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png"
}

Poster in formato 16:9

{
  "model": "gpt-image-2",
  "prompt": "A futuristic city night poster with neon lights, wet streets, cinematic composition, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "medium",
  "output_format": "jpeg"
}

Come vengono restituiti i risultati

Questo endpoint compatibile con OpenAI non restituisce inizialmente una risposta di invio attività contenente data.jobId per un polling successivo:

• Con stream: false, la richiesta HTTP corrente attende il completamento e restituisce URL delle immagini nella risposta JSON.
• Con stream: true, la connessione SSE corrente resta aperta fino a image_generation.completed e [DONE].

Non usare GET https://api.apihop.ai/v1/jobs/{id} per recuperare i risultati di questo endpoint. Usa Recuperare un processo asincrono solo quando un endpoint di creazione asincrona restituisce esplicitamente un jobId.

Risposta senza streaming

La risposta contiene URL delle immagini. usage è incluso quando la route del fornitore fornisce informazioni di misurazione.

{
  "created": 1777270000,
  "data": [
    {
      "url": "https://image.example.com/generated/123456789012345678/0.png"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 1234,
    "total_tokens": 1254
  }
}

Risposta in streaming

event: image_generation.completed
data: {"type":"image_generation.completed","data":[{"index":0,"url":"https://image.example.com/generated/123456789012345678/0.png"}],"usage":{"input_tokens":20,"output_tokens":1234,"total_tokens":1254}}

data: [DONE]

Riferimento delle dimensioni

Risposta di errore

Consulta Codici di errore e risoluzione dei problemi per il riferimento completo, le differenze tra protocolli e i passaggi diagnostici.

{
  "code": 10000,
  "message": "prompt is required",
  "type": "api_error"
}

Errori comuni:

• 400: parametri obbligatori mancanti o combinazione non supportata
• 401: autenticazione fallita o chiave API errata
• 402: credito insufficiente
• 404: modello inesistente o non abilitato
• 429: limite di frequenza superato
• 5xx: servizio temporaneamente non disponibile o generazione di immagini fallita