Generasi Gambar

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.neosantara.xyz/v1",
    api_key=os.environ["NEOSANTARA_API_KEY"]
)

response = client.images.generate(
    model="imagen-4.0-fast",
    prompt="Pemandangan sawah terasering di Ubud Bali saat matahari terbit, fotorealistik.",
    size="1024x1024",
    n=1
)

image_url = response.data[0].url
print(f"URL Gambar: {image_url}")

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.neosantara.xyz/v1",
  apiKey: process.env.NEOSANTARA_API_KEY,
});

const response = await client.images.generate({
  model: "imagen-4.0-fast",
  prompt: "Pemandangan sawah terasering di Ubud Bali saat matahari terbit, fotorealistik.",
  size: "1024x1024",
  n: 1,
});

console.log("URL Gambar:", response.data[0].url);

curl -X POST https://api.neosantara.xyz/v1/images/generations \
  -H "Authorization: Bearer $NEOSANTARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "imagen-4.0-fast",
    "prompt": "Pemandangan sawah terasering di Ubud Bali.",
    "size": "1024x1024",
    "n": 1
  }'

​

Parameter Permintaan

​

Arsitektur Teknis & Caching

• Sinkron vs Asinkron: Endpoint standar /v1/images/generations dirancang untuk integrasi langsung waktu nyata. Untuk proses batch atau model resolusi tinggi, gunakan Responses API dengan parameter background: true untuk menghindari HTTP timeout.
• CDN Ephemeral & TTL Caching: Gambar yang dihasilkan disajikan melalui CDN berkecepatan tinggi dengan URL bertanda tangan sementara. Tautan berlaku selama 5 menit (TTL). Unduh gambar ke storage permanen (S3/GCS/R2) jika membutuhkan retensi jangka panjang.
• Perlindungan SSRF: Saat menyediakan URL gambar input untuk tugas manipulasi/inpainting, gateway memvalidasi rentang IP publik dan memblokir alamat loopback serta jaringan privat untuk mencegah Server-Side Request Forgery (SSRF).
• Penagihan Rupiah: Biaya generasi gambar dihitung per unit gambar yang berhasil dibuat (per-image pricing), bukan berdasarkan token. Biaya langsung didebet dari saldo deposit Rupiah Anda.

​

Galeri Hasil Gambar

​

Generasi Cepat (Fast Inference)

​

Artistik & Fantasi

​

Fotografi Realistis

​

Transformasi Gambar (Image-to-Image)

Gambar Asli

Gambar input penari tradisional Bali.

Transformasi Sketsa

Hasil transformasi gaya sketsa arang artistik.

​

Model Generasi Gambar yang Tersedia