Salta al contenuto
GetAPI
Italiano
English简体中文繁體中文日本語한국어EspañolPortuguês (Brasil)FrançaisDeutschРусскийItalianoالعربية
Menu

GetAPI.ONE

Generare immagini con GetAPI.ONE

Scegliere modello immagine dal catalogo attuale, inviare richiesta dichiarata minima alla rotta ONE, validare formato e conservare output sicuro.

Preparare una richiesta supportata

  • Aprire catalogo e selezionare modello con endpoint generazione immagini dichiarato.
  • Controllare prezzi prima di chiamate fatturabili; la guida non fissa prezzi.
  • Iniziare con un output e soli campi del contratto.
text
POST https://www.getapi.one/v1/images/generations

Inviare una generazione minima

  1. Impostare GETAPI_ONE_API_KEY in un processo affidabile.
  2. Copiare ID esatto del modello immagine attuale.
  3. Descrivere soggetto, composizione e vincoli.
  4. Richiedere un risultato e ampliare campi solo dopo supporto confermato.
  5. Decodificare base64 localmente con limiti. Registrare eventuali URL per downloader approvato con regole uscita/host e rivalidazione redirect, senza accedervi dal processo API.
shell
curl --fail-with-body https://www.getapi.one/v1/images/generations \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<IMAGE_MODEL_ID_FROM_CURRENT_CATALOG>",
    "prompt": "A clean product diagram of a secure server-side API flow",
    "n": 1
  }' > image-response.json
Esaminare data[0] e salvare i byte
import base64
import json
from pathlib import Path
from urllib.parse import urlsplit

payload = json.loads(Path("image-response.json").read_text(encoding="utf-8"))
item = payload["data"][0]

if item.get("b64_json"):
    image_bytes = base64.b64decode(item["b64_json"], validate=True)
    if len(image_bytes) > 25 * 1024 * 1024:
        raise ValueError("Image exceeds the local 25 MB safety limit")
    Path("generated-image.bin").write_bytes(image_bytes)
elif item.get("url"):
    url = item["url"]
    parsed = urlsplit(url)
    if parsed.scheme != "https" or not parsed.hostname:
        raise ValueError("Refusing an invalid or non-HTTPS image URL")
    # Do not dereference provider-controlled URLs from a generic server example.
    # Give this record to an approved downloader that enforces your egress and
    # host policy, rejects private/link-local/loopback destinations, revalidates
    # every redirect, sends no ONE credential, and bounds the response bytes.
    Path("generated-image-url.txt").write_text(url, encoding="utf-8")
    print("URL recorded for an egress-controlled downloader")
else:
    raise ValueError("Expected data[0].url or data[0].b64_json")

Valutare il risultato

ControlloCondizione di superamento
Fedeltà alla richiestaSoggetto e composizione richiesti sono presenti.
Sicurezza e dirittiOutput adatto al pubblico e diritti posseduti sugli input.
Contratto di rispostaEsaminare data[0].url o data[0].b64_json, validare e salvare i byte.
Registro operativoID modello, versione richiesta, ID se presente e risultato registrati senza chiave.

Verificare il risultato previsto

  • HTTP riuscito e corpo contenente il formato immagine del modello scelto.
  • Il file base64 decodificato si apre come immagine prevista; oppure URL registrato e recuperato solo dal downloader approvato con uscita controllata.
  • La console ONE registra richiesta o utilizzo.

Correggere errori immagine

SintomoAzione
Parametro non supportatoRimuovere campi opzionali dimensioni, qualità, formato o quantità finché confermati per il modello esatto.
Output vuoto o inutilizzabileEsaminare JSON completo e gestire il reale campo URL o dati codificati, senza presumere un formato unico.
Rifiuto per politiche o inputModificare input anziché ripetere la stessa richiesta.

Conservare input e output in sicurezza

  • Tenere chiavi sul server e validare lunghezza richiesta, quantità e campi opzionali prima dell'inoltro.
  • Non inviare immagini riservate o dati personali salvo gestione dati approvata.
  • Considerare URL temporanee salvo contratto esplicito contrario; copiare output approvati in storage controllato.
  • Non inoltrare mai Authorization GetAPI.ONE a un URL immagine restituito.
  • Trattare URL restituite come non affidabili: imporre regole esplicite di uscita e host, bloccare destinazioni private/link-local/loopback e rivalidare ogni redirect nel downloader dedicato.

Passaggi successivi