Dokumentasi API Pembuatan Gambar

KozeAI menyediakan antarmuka pembuatan dan pengeditan gambar bergaya OpenAI. Antarmuka gambar mengembalikan format respons gambar yang seragam, tetapi ukuran, kualitas, gambar referensi, dan format keluaran yang didukung model tertentu ditentukan oleh adaptor saluran.

Autentikasi

Semua permintaan diautentikasi melalui Authorization: Bearer .

Digunakan setelah membuat token API di konsol.

export KOZEAI_API_KEY='sk-your-token'

export KOZEAI_BASE_URL='https://your-kozeai-domain'

API Overview

Model gambar juga dapat dipanggil melalui

/v1/chat/completions

. Antarmuka obrolan akan mengekstrak gambar dari teks dan pesan, lalu mengonversinya ke format antarmuka gambar; disarankan untuk menggunakan antarmuka gambar khusus di atas saat terhubung langsung.

1. Gambar Generasi

curl '$KOZEAI_BASE_URL/v1/images/generations' \

-H 'Authorization: Bearer $KOZEAI_API_KEY' \

-H 'Content-Type: application/json' \

-d '{

'model': 'gpt-image-1',

'prompt': 'An orange cat sitting by the window, cinematic light and shadow',

'n': 1,

'size': '1024x1024',

'quality': 'auto',

'response_format': 'url'

}

Permintaan Parameter

Metode	Jalur	Tipe Konten	Tujuan
POST	/v1/images/generations	application/json	Teks yang dihasilkan Gambar

Disarankan untuk menggunakan string yang tidak kosong.

Parameter	Tipe	Wajib	Deskripsi
model	string	Apakah	Nama model gambar. Model yang tersedia sebenarnya berdasarkan hasil dari /v1/models.
prompt	string	Ya	Deskripsi konten gambar.
n	integer	Tidak	Jumlah elemen yang dihasilkan, default 1, rentang validasi umum adalah 1-10.
ukuran	string	Tidak	Ukuran gambar atau rasio aspek, nilai spesifik ditentukan oleh model.
kualitas	string	Tidak	Kualitas level, nilai umum adalah standard, hd, auto, 2k, 4k.
response_format	string	Tidak	Nilai umum adalah url atau b64_json.
style	any	No	Parameter gaya yang kompatibel dengan OpenAI.
user / user_id	any	No	Pengidentifikasi pengguna pemanggil.
extra_fields	object	No	Parameter terstruktur tambahan; Efektivitasnya bergantung pada adaptor saluran.
latar belakang	apa saja	Tidak	Pengaturan latar belakang.
moderasi	apa saja	Tidak	Pengaturan moderasi konten.
format_output	apa saja	Tidak	Format gambar output.
kompresi_output	integer	Tidak	Parameter kompresi output, didukung oleh beberapa model gambar Codex.
gambar_parsial	integer	Tidak	Beberapa parameter terkait gambar/streaming, didukung oleh beberapa model gambar Codex.
tanda_air	boolean	Tidak	Pengalihan tanda air, efektivitasnya bergantung pada saluran.
watermark_enabled	any	No	Kompatibel dengan beberapa parameter watermark hulu.
image	string/object/array	No	Merujuk ke URL gambar, URL data, atau objek gambar; Beberapa saluran akan secara otomatis memasuki proses pengeditan.

Ukuran dan Pengaturan Default DALL·E

dall-e-3

Model	ukuran Diizinkan Nilai	Nilai Default
dall-e-2 / dall-e	256x256、512x512、1024x1024	1024x1024
1024x1024、1024x1792、1792x1024	1024x1024
gpt-image-1 / gpt-image-2	Ditentukan oleh model hulu	quality=auto

size Harus menggunakan huruf setengah lebar x, jangan menggunakan tanda perkalian ×.

2. Pengeditan Gambar

Permintaan pengeditan standar menggunakan formulir multipart, dengan kolom gambar bernama image. Beberapa gambar input dapat digunakan kembali menggunakan image atau image[].

curl '$KOZEAI_BASE_URL/v1/images/edits' \
-H 'Authorization: Bearer $KOZEAI_API_KEY' \
-F 'model=gpt-image-1' \
-F 'prompt=Ubah latar belakang menjadi pemandangan malam dan pertahankan detail subjek' \
-F 'image=@./input.png' \
-F 'n=1' \
-F 'quality=standard'

Formulir Umum Kolom:

Kolom	Tipe	Deskripsi
model	string	Model pengeditan gambar.
prompt	string	Persyaratan pengeditan.
gambar / gambar[]	file	Masukkan gambar, minimal satu.
mask	file	Mask image; Terutama digunakan untuk alur kerja pengeditan yang kompatibel dengan OpenAI/Codex.
n	integer	Jumlah elemen yang dihasilkan, default 1, rentang 1-10.
size	string	Ukuran atau rasio keluaran.
quality	string	Kualitas keluaran.
format_respons	string	url atau b64_json, tergantung pada saluran.
tanda_air	boolean	Pengalihan tanda air, tergantung pada saluran.

Beberapa saluran juga mendukung permintaan pengeditan JSON, seperti mengatur gambar ke URL data atau URL gambar; namun, jalur pengeditan OAuth OpenAI, Codex, dan ChatGPT lebih memilih menggunakan multipart.

3. Perbedaan Saluran

Saluran	Perilaku Tambahan
OpenAI / DALL·E	Diteruskan oleh bidang gambar OpenAI; DALL·E memiliki validasi ketat untuk size.
xAI	size akan dikonversi menjadi aspect_ratio dan resolution; response_format defaultnya adalah b64_json. Parameter JSON tambahan seperti aspect_ratio dan resolution didukung.
Flow	size Mendukung rasio aspek 1:1, 16:9, 9:16, 4:3, dan 3:4; quality=2k/4k memicu proses penskalaan. Gambar referensi diunggah melalui image.
Jimeng / Dreamina	size digunakan untuk pemetaan rasio aspek; quality=hd akan memilih resolusi yang lebih tinggi; gambar referensi akan masuk ke proses pencampuran.
Codex	Selain itu, mendukung input_fidelity, mask, stream, output_format, output_compression, partial_images.
ChatGPT OAuth	Sebenarnya menggunakan model, prompt, n dan mengedit gambar; parameter gambar lainnya mungkin diabaikan.
Grok	response_format Hanya mendukung url atau b64_json, defaultnya adalah url; permintaan pengeditan memerlukan setidaknya satu gambar.

Parameter yang tidak didefinisikan dalam bidang publik tidak secara otomatis dijamin akan diteruskan. Hanya parameter tambahan yang secara eksplisit dibaca oleh adaptor saluran yang sesuai yang akan berlaku.

4. Format Respons

{

"created": 1751000000,

"data": [
{
"url": "https://example.com/generated.png",

"b64_json": "",

"revised_prompt": "Seekor kucing oranye duduk di dekat jendela, cahaya dan bayangan sinematik"

}
]

}

Saat `response_format=b64_json`, konten gambar terletak di `data[].b64_json`; saat menggunakan format URL, alamat gambar terletak di `data[].url`. Saluran yang berbeda mungkin mengembalikan string kosong untuk bidang yang tidak digunakan.

5. Contoh panggilan JavaScript

const baseURL = process.env.KOZEAI_BASE_URL;

const apiKey = process.env.KOZEAI_API_KEY;

const response = await fetch(`${baseURL}/v1/images/generations`, {
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,

'Content-Type': 'application/json',

},
body: JSON.stringify({
model: 'gpt-image-1',

prompt: 'Ilustrasi produk minimal dengan latar belakang putih',

n: 1, size: 1024x1024,

response_format: url,

}),

});

if (!response.ok) {

throw new Error(await response.text());

}
const result = await response.json();

console.log(result.data[0].url || result.data[0].b64_json);

6. Kesalahan Umum

• model diperlukan: Nama model tidak diberikan.
• prompt diperlukan: Kata prompt kosong.
• n harus antara 1 dan 10: Jumlah generasi melebihi batas publik.
• ukuran harus salah satu dari ...: DALL·E menggunakan ukuran yang tidak didukung.
• gambar diperlukan: Antarmuka pengeditan tidak mengunggah gambar atau memberikan referensi gambar yang dapat dikenali.
• tidak didukung ... response_format: Saluran target tidak mendukung format output yang diminta.